MCPセットアップガイド

このガイドでは、ChainStream MCP Serverの設定を迅速に行う方法を説明します。

前提条件

要件	詳細	取得方法
ChainStreamアカウント	登録済みアカウント	サインアップ
APIキー	認証用の `X-API-KEY`	Dashboard → Apps → Create App
AIクライアント	Claude Desktop / Cursor / カスタムクライアント	インストール済み

MCPエンドポイント

ChainStreamはホスティングされたMCP Serverを提供しています。ローカルインストールは不要です — 以下に直接接続してください：

https://mcp.chainstream.io/mcp

設定手順

APIキーの取得

ChainStream Dashboardにログイン
Applicationsに移動
Create New AppをクリックしてAPIキーをコピー

AIクライアントの設定

Claude Desktop
Cursor IDE
カスタムクライアント

設定ファイルのパス：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

オプションA — クラウドエンドポイント（推奨）：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

オプションB — ローカルnpmパッケージ（stdio）：

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

ファイルが存在しない場合は手動で作成してください。他のMCP Serverの設定がある場合は、既存の mcpServers オブジェクトに chainstream の設定を追加してください。

設定ファイルのパス: .cursor/mcp.json（プロジェクトレベル）または Cursor Settings → Features → MCP ServersオプションA — クラウドエンドポイント：

{
  "mcpServers": {
    "chainstream": {
      "url": "https://mcp.chainstream.io/mcp",
      "headers": {
        "X-API-KEY": "your_api_key"
      }
    }
  }
}

オプションB — ローカルnpmパッケージ（stdio）：

{
  "mcpServers": {
    "chainstream": {
      "command": "npx",
      "args": ["@chainstream-io/mcp"],
      "env": {
        "CHAINSTREAM_API_KEY": "your_api_key"
      }
    }
  }
}

HTTP経由でクラウドエンドポイントに接続：

エンドポイント	URL	メソッド
MCPエンドポイント	`https://mcp.chainstream.io/mcp`	POST

認証: X-API-KEY ヘッダーでAPIキーを渡します。サンプルコード：

import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
import { Client } from '@modelcontextprotocol/sdk/client/index.js';

const transport = new StreamableHTTPClientTransport(
  new URL('https://mcp.chainstream.io/mcp'),
  {
    requestInit: {
      headers: {
        'X-API-KEY': process.env.CHAINSTREAM_API_KEY
      }
    }
  }
);

const client = new Client({
  name: 'my-client',
  version: '1.0.0'
});

await client.connect(transport);

const { tools } = await client.listTools();
console.log('Available tools:', tools.map(t => t.name));

クライアントの再起動

設定後、AIクライアントを完全に終了して再起動し、変更を反映させてください。

Claude Desktop: 完全に終了（最小化ではなく）してから再度開く
Cursor: IDEを再起動

設定の確認

テストコマンド

AIクライアントで以下のテスト質問を入力してください：

What is the SOL token on Solana? Is it safe?

期待される結果

設定が成功していれば、AIは以下を行うはずです：

tokens_search を呼び出してSOLトークンを検索
tokens_analyze を呼び出してセキュリティと保有者データを取得
自然言語でサマリーを返す

AIがツールを呼び出さない場合やエラーが返される場合は、下記のトラブルシューティングを参照してください。

トラブルシューティング

認証に失敗

考えられる原因：

APIキーの入力ミス
- 余分なスペースがないか確認
- 完全にコピーされたか確認
APIキーが無効化または期限切れ
- Dashboardでキーの状態を確認
- 必要に応じて新しいキーを作成
ヘッダー名が間違っている
- クラウドエンドポイント：X-API-KEY ヘッダーを使用
- npmパッケージ：CHAINSTREAM_API_KEY 環境変数を使用

解決策：

Dashboard → Applicationsでキーを確認
直接テスト：curl -H "X-API-KEY: your_key" https://api.chainstream.io/v2/blockchain

接続に失敗

考えられる原因：

ネットワークの問題
- ネットワーク接続を確認
- https://mcp.chainstream.io へのアクセスを確認
設定フォーマットのエラー
- JSONフォーマットが正しいか確認
- URLのスペルが正しいか確認

解決策：

curl -I https://mcp.chainstream.io/mcp

設定ファイルが反映されない

考えられる原因：

設定ファイルのパスが間違っている
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
JSONフォーマットエラー
- JSONバリデーターで確認
クライアントが再起動されていない
- 完全に終了して再起動

解決策：

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json | python -m json.tool

ツール呼び出し失敗：クォータ超過

考えられる原因：

プランのクォータを使い切った
リクエスト頻度が高すぎてレート制限が発動

解決策：

Dashboardでクォータ使用量を確認
プランをアップグレードしてクォータを増やす

データ返却の遅延またはタイムアウト

考えられる原因：

ネットワーク遅延
クエリのデータ量が多すぎる

解決策：

ネットワーク接続を確認
1回のクエリあたりのデータ量を減らす
時間を置いて再試行

次のステップ

ツールカタログ

利用可能な全ツールと使用例を確認

AIエージェントチュートリアル

AIトレーディングアシスタントを構築

はじめに

データコンセプト

AIインフラストラクチャ

CLI

セキュリティとコンプライアンス

インテグレーション

リソース

法務・ポリシー

MCPセットアップガイド

前提条件

MCPエンドポイント

設定手順

設定の確認

テストコマンド

期待される結果

トラブルシューティング

次のステップ

ツールカタログ

AIエージェントチュートリアル

はじめに

データコンセプト

AIインフラストラクチャ

CLI

セキュリティとコンプライアンス

インテグレーション

リソース

法務・ポリシー

​前提条件

​MCPエンドポイント

​設定手順

​設定の確認

​テストコマンド

​期待される結果

​トラブルシューティング

​次のステップ

ツールカタログ

AIエージェントチュートリアル

前提条件

MCPエンドポイント

設定手順

設定の確認

テストコマンド

期待される結果

トラブルシューティング

次のステップ