> ## Documentation Index
> Fetch the complete documentation index at: https://docs.morph-data.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailchimp

## Mailchimp に接続する

コネクターについての概要は以下のリンクを参照してください。

* [DB/SaaSと接続する](/docs/ja/develop/guides/integration)

<Tabs>
  <Tab title="ダッシュボード">
    <Steps>
      <Step title="Connectorを作成する">
        トップページの「Connectors」タブを選択し「Create」ボタンを押下します。

        <img src="https://mintcdn.com/queue-4c50ebb3/evgQaQjX53Vch8Y5/assets/images/docs/advanced/connectors/connect-data-platform-connection.png?fit=max&auto=format&n=evgQaQjX53Vch8Y5&q=85&s=19c6e7afc70da565c2a8ab4f75469549" alt="Connection" width="1907" height="711" data-path="assets/images/docs/advanced/connectors/connect-data-platform-connection.png" />
      </Step>

      <Step title="Mailchimpの認証情報を入力する">
        Mailchimpを選択しサインインボタンを押下します。

        <img src="https://mintcdn.com/queue-4c50ebb3/evgQaQjX53Vch8Y5/assets/images/docs/advanced/connectors/connect-data-platform-mailchimp-create.png?fit=max&auto=format&n=evgQaQjX53Vch8Y5&q=85&s=b097ec2d4cd565661b8f96ffd18ff553" alt="Mailchimp Connection Create" width="1689" height="786" data-path="assets/images/docs/advanced/connectors/connect-data-platform-mailchimp-create.png" />

        入力後Createボタンを押下すると作成が完了します。パラメータに不備がある場合はエラーが表示されるため接続内容が正しいか再度ご確認ください。
      </Step>

      <Step title="作成したコネクターからaccess_tokenを取得する">
        作成が成功すると一覧表示からコネクター名を取得することができます。

        専用の関数を使用してPythonコード上でコネクターを名を入力しaccess\_tokenを取得します。

        <CodeGroup>
          ```python Python theme={"dark"}
          import morph
          from morph import MorphGlobalContext
          from morph_lib.api import get_auth_token


          @morph.func
          def main(context: MorphGlobalContext):
              access_token = get_auth_token("connection_name")
              # ↓↓↓ access_tokenを使用した処理　↓↓↓
          ```
        </CodeGroup>
      </Step>
    </Steps>
  </Tab>

  <Tab title="ローカル">
    <Info>ローカルでは現在直接\~/.morph/connections.ymlに認証情報を記述する必要があります。それ以外の方式はダッシュボードで作成してください。</Info>

    <Steps>
      <Step title="connections.ymlを編集する">
        `~/.morph/connections.yml`にファイルが存在しない場合は事前に作成してから編集してください。

        ```bash shell theme={"dark"}
        mkdir ~/.morph
        touch ~/.morph/connections.yml
        ```

        ```yaml theme={"dark"}
        connections:
          mailchimp-connection: # 一意な任意の名前
            type: mailchimp # 固定
            method: mailchimp_oauth # 固定
            refresh_token: str
            client_id: str
            client_secret: str
            redirect_uri: str
            access_token: str # 任意
        ```
      </Step>

      <Step title="コード上でコネクターを使いデータを取得する">
        専用の関数を使用してPythonコード上でコネクター名を入力しaccess\_tokenを取得します。

        <CodeGroup>
          ```python Python theme={"dark"}
          import morph
          from morph import MorphGlobalContext
          from morph_lib.api import get_auth_token


          @morph.func
          def main(context: MorphGlobalContext):
              access_token = get_auth_token("connection_name")
              # ↓↓↓ access_tokenを使用した処理　↓↓↓
          ```
        </CodeGroup>
      </Step>
    </Steps>

    access\_tokenのリフレッシュはダッシュボードの機能のためローカル環境では記載したものが常時使用されます。

    <Warning>
      実際にコネクターを指定してファイルを実行した場合の優先順位は以下の通りです。
      また`morph deploy`を行なった環境ではダッシュボードで作成したコネクターのみが使用可能なため注意してください。

      1. ローカルマシンの`~/.morph/connections.yml`に記載されたコネクター
      2. クラウドで登録されたコネクター
    </Warning>
  </Tab>
</Tabs>
