Twelve Data

Twelve Data MCP サーバー

Claude、ChatGPT、その他の AI アシスタントを Twelve Data の金融 API に接続します。リアルタイムおよび過去の価格、60 種類以上のテクニカル指標、ファンダメンタルズ、決算、配当、ETF、企業ニュース、市場の値上がり・値下がり銘柄などを利用できます。

Twelve Data のアカウントが必要です。twelvedata.com で登録してください。

利用方法は 2 つあります。ほとんどの方にはクラウドサーバー（オプション 1）がおすすめです。インストールは不要です。

---

オプション 1 — クラウドサーバーを利用する（推奨）

AI アシスタントをホスト型サーバーに接続します。

https://mcp.twelvedata.com/mcp

これで完了です。インストールも、API キーのコピー＆ペーストも必要ありません。接続するとブラウザーウィンドウが開き、Twelve Data アカウントにログインできます。個人用 API キーは自動的にリンクされ、アカウントに紐づいたままになります。

追加方法

Claude（デスクトップ／Web）と ChatGPT は、カスタムコネクター／MCP サーバーに対応しています。

1. アシスタントの コネクター（または 連携／MCP サーバー）設定を開きます。
2. URL https://mcp.twelvedata.com/mcp を指定して、新しいコネクターを追加します。
3. メッセージが表示されたら、接続／ログインをクリックします。ブラウザーで Twelve Data のログインページが開きます。
4. アクセスを許可すれば完了です。「AAPL の RSI は？」 や 「TSLA の最新決算を見せて」 のように質問してみましょう。

メニューの正確な名称はアプリやバージョンによって異なりますが、手順は常に同じです。URL を追加してから、ブラウザーのポップアップでログインします。

MCP ホストはトークンを発行しません。コネクターの URL は https://mcp.twelvedata.com/mcp です。クライアントは、その URL の保護されたリソースのメタデータに従い、そこに記載された認可サーバーにアクセスする必要があります。ホストのルート（404 を返します）、またはこのホストの /register や /.well-known/oauth-authorization-server をコネクターに指定しないでください。

Perplexity（カスタムリモートコネクター）

Perplexity Pro、Max、Enterprise のユーザーは、ホスト型サーバーをカスタムリモートコネクターとして追加できます。これはアカウントごとに設定するもので、Perplexity の公開キュレーションディレクトリへの掲載ではありません。

1. Perplexity で アカウント設定 → コネクター → + カスタムコネクター を開き、リモートを選択します。Enterprise では、カスタムコネクターを事前に管理者が許可する必要がある場合があります。
2. 名前に Twelve Data、MCP サーバー URLに https://mcp.twelvedata.com/mcp を設定します。
3. 認証には OAuth、トランスポートには Streamable HTTP を選択します。Perplexity がサーバーの保護されたリソースのメタデータに記載された認可サーバーで動的クライアント登録を利用できるよう、クライアント ID とクライアントシークレットは空欄のままにします。
4. Perplexity のカスタムコネクターに関する確認事項に同意し、追加をクリックします。次に Twelve Data コネクターのカードをクリックして認証を開始し、Twelve Data アカウントにサインインしてアクセスを許可します。
5. コネクターが有効になったら、次のプロンプトを試してください。
   • 「Twelve Data を使って AAPL のシンボルを調べて。」
   • 「Twelve Data を使って、価格と出来高を含む AAPL の最新の気配値を取得して。」
   • 「Twelve Data を使って、AAPL の直近 5 日分の日次終値を表示して。」
   • 「Twelve Data を使って、AAPL の RSI を表示して。」

各ユーザーはそれぞれ自分の Twelve Data アカウントでサインインします。Enterprise 管理者がコネクターを共有する場合は、各メンバーに個別認証を求めてください。コネクターの API キー認証欄に Twelve Data の API キーを貼り付けないでください。

OAuth ウィンドウがブロックされる、ログインに失敗する、またはアイドル状態の後にツールが停止する場合は、Twelve Data コネクターを開いて無効にし、再度有効にしてからサインインしてください。コネクターを API キー認証に切り替えるのではなく、この方法で再接続してください。URL が末尾のスラッシュなしで正確に https://mcp.twelvedata.com/mcp になっていること、および Twelve Data のプランに要求するデータが含まれていることを確認してください。現在の設定画面については、Perplexity のカスタムリモートコネクターガイド をご覧ください。

Codex（CLI、デスクトップ、IDE）

このリポジトリをインストールしたり、API キーをコピーしたりせずに、ホスト型 MCP サーバーを Codex に追加できます：

codex mcp add twelvedata --url https://mcp.twelvedata.com/mcp
codex mcp list

add コマンドを実行すると OAuth が開始されます。ブラウザーで Twelve Data へのサインインを完了してください。後で再度認証する必要がある場合は、codex mcp login twelvedata を実行します。Codex で /mcp を使って接続を確認し、次のように依頼します：「Twelve Data を使って AAPL の最新の株価を取得して。」 および 「Twelve Data を使って AAPL の RSI を表示して。」 接続を解除するには、codex mcp remove twelvedata を実行します。

公開プラグインリポジトリは https://github.com/MazeBraker/twelvedata-skills です。スキルと同じホスト型 MCP をインストールします：

codex plugin marketplace add https://github.com/MazeBraker/twelvedata-skills
codex plugin add twelvedata@twelvedata-skills

---

オプション 2 — API キーを使って自分で実行する

サーバーを自分のマシンで実行しますか？必要なのは Twelve Data API キーだけです。OAuth の設定は不要です。twelvedata.com → ダッシュボード → API Keys で取得してください。

1. インストール

Python 3.10 以降が必要です（3.12 を推奨。macOS では brew install [email protected] または make python-install）。

make install

2. API キーを追加する

プロジェクトのルートに .env ファイルを作成し、自分だけが読み取れるようにキーを設定します：

echo 'TWELVE_DATA_API_KEY=your_api_key_here' > .env
chmod 600 .env

サーバーは .env からキーを読み取り、すべてのリクエストでそのキーを使用します。ログインは不要です。

3. stdio 経由で接続する

Claude Desktop — ~/Library/Application Support/Claude/claude_desktop_config.json に追加します：

{
  "mcpServers": {
    "twelvedata": {
      "command": "/path/to/mcp/.venv/bin/python",
      "args": ["/path/to/mcp/src/server.py"]
    }
  }
}

システムの Python ではなく、.venv/bin/python のパスを使用してください（macOS に付属するのは 3.9 で、このサーバーには 3.10 以降が必要です）。設定を編集したら Claude Desktop を再起動してください。

Claude Code：

claude mcp add twelvedata -- /path/to/mcp/.venv/bin/python /path/to/mcp/src/server.py

4. HTTP 経由で接続する

make run           # serves http://localhost:8000/mcp

claude mcp add --transport http twelvedata http://localhost:8000/mcp

5. Docker で実行する

docker build -t twelvedata-mcp .
docker run --rm --env-file .env -p 127.0.0.1:8000:8000 twelvedata-mcp

--env-file を使うと、シェルの履歴にキーが残りません。手順 4 と同じように http://localhost:8000/mcp に接続します。Docker では OAuth ログインはサポートされていません。

6. セキュリティ

• make run と Docker は、デフォルトで 0.0.0.0 上の /mcp を 認証なしで提供します。
• すべての呼び出しは あなたの 認証情報で処理されます。
• ポートにアクセスできる人なら誰でも auth_status と oauth_configure を呼び出せます。デフォルトのバインド設定では Host ヘッダーも Origin ヘッダーもチェックされないため、DNS リバインディングを通じて、開いた Web ページからも呼び出せます。
• MCP_HOST=127.0.0.1 make run を実行すると、サーバーをローカルに限定し、MCP SDK の Host および Origin チェックが有効になります。
• MCP_HOST=127.0.0.1 の場合、ngrok は --host-header=rewrite を指定して起動したときにのみ動作します。

7. トラブルシューティング

まずクライアントから auth_status を呼び出してください。API キーが設定されているか、保存済みトークン、検出されたホスト、リダイレクト URI が表示されます。通常、何が不足しているかを確認するにはこれで十分です。

---

質問できること

• 価格 — 株式、ETF、外国為替、暗号資産、コモディティ（リアルタイムおよび過去のデータ）
• テクニカル指標 — RSI、MACD、SMA、BBANDS、ATR など 60 種類以上
• ファンダメンタルズ — 財務諸表、決算、配当、株式分割、企業プロフィール、時価総額、主要統計、IPO カレンダー
• ファンド — ETF および投資信託のプロフィール、パフォーマンス、保有銘柄、リスク
• ニュース — 企業ニュースおよびプレスリリース
• 市場インテリジェンス — 値上がり・値下がり銘柄、為替レート、アナリスト評価、目標株価
• 規制関連 — SEC/EDGAR 提出書類、インサイダー取引、機関投資家の保有状況

シンボル形式：株式は AAPL、暗号資産は BTC/USD、外国為替は EUR/USD です。

---

パートナー

独自の公開インスタンスを運用する場合や、専用の OAuth ログインを設定する場合は、 パートナー契約が必要です。twelvedata.com までお問い合わせください。 設定ガイドと OAuth 認証情報をご提供します。