概要

Quicknode MCPサーバーは、QuicknodeアカウントをChatGPT、Codex、Claude Code、Claude Desktop、Cursor、VS Codeなど、MCP対応のAIアシスタントに接続します。接続が完了すると、ダッシュボードを操作したりAPIスクリプトを作成したりすることなく、自然言語を使ってエンドポイントの作成・管理、利用状況の監視、セキュリティ設定の構成、および課金データの確認を行うことができます。

このサーバーは、以下の場所でリモートホスティングされています。 https://mcp.quicknode.com/mcp そして、OAuth を通じて認証を行います。これは Quicknode の 管理用API、自然言語による指示をAPI操作に変換します。このアシスタントは、ユーザーの要求を解釈し、適切なツールを選択し、確認後にそれを実行します。

要約

• Quicknodeは、Anthropic MCPディレクトリに掲載されている公式コネクタです。Claudeで直接追加するか、「カスタマイズ」＞「コネクタ」から見つけてください。
• Quicknodeは、以下のプラットフォームでもネイティブで利用可能です。 ChatGPT そして コーデックス — から直接インストールする ChatGPTアプリ一覧 または、以下の方法でも /plugin Codex内
• その他のすべてのクライアント（Cursor、VS Code、Windsurf、Zed）は、以下を指定して接続します。 https://mcp.quicknode.com/mcp およびOAuthによる認証
• CI/CD および非対話型環境では、OAuth をスキップして API キーを直接渡してください。詳細は「API キーの使用」を参照してください。
• ダッシュボードやAPIスクリプトを一切使用せずに、自然言語でエンドポイントの管理、利用状況の監視、セキュリティルールの設定、および請求内容の確認を行うことができます

要件

• Quicknodeアカウント
• MCP対応のAIアシスタント（ChatGPT、Codex、Claude Code、Claude Desktop、Cursor、VS Code、Windsurf、Zed、またはこれらに類するもの）

設定

以下のクライアントごとの手順に従って、Quicknode MCPサーバーをアシスタントに追加してください。

クロード

クロード・ウェブ

Quicknodeは、Anthropic MCPディレクトリに掲載されている公式コネクタです。Claudeでこれを接続するには：

1. Quicknodeコネクタのページにアクセスするか、ブラウザでClaudeを開き、「カスタマイズ」＞「コネクタ」の順に選択して、ディレクトリ内からQuicknodeを探してください。
2. 「接続」をクリック
3. ブラウザウィンドウが開きます。Quicknodeアカウントでログインし、役割（管理者または 閲覧者）を選択して、アクセスを承認してください。

Claude デスクトップ

Quicknode MCPサーバーをClaude Desktopアプリに追加するには：

1. 「カスタマイズ」＞「コネクタ」に移動します
2. ディレクトリから「Quicknode」を探して、「接続」をクリックしてください
3. ブラウザウィンドウが開きます。Quicknodeアカウントでログインし、役割（管理者または 閲覧者）を選択して、アクセスを承認してください。

クロード・コード

Quicknode MCP サーバーを Claude Code に追加するには、ターミナルで次のコマンドを実行してください：

1. サーバーを追加します：

claude mcp 追加 --transport http quicknode https://mcp.quicknode.com/mcp

2. 「Claude Code」を起動して、次のように入力してください /mcp 開いたブラウザウィンドウでサーバーを認証する

導入範囲

デフォルトでは、上記のコマンドはサーバーをローカルスコープ（現在のプロジェクトのみ）にインストールします。Claude Code では、以下の 3 つのスコープがサポートされています：

• ローカル（既定） — 現在のプロジェクト内で、あなただけが利用できます
• プロジェクト (--scopeプロジェクト) — チームと共有するには、 .mcp.json プロジェクトのルートにあるファイル
• ユーザー (--scope user) — すべてのプロジェクトでご利用いただけます

ユーザー全体にグローバルにインストールするには、次の --scope user flag:

claude mcp 追加 --transport http --scope ユーザー quicknode https://mcp.quicknode.com/mcp

OpenAIOpenAI

ChatGPT

Quicknode MCPサーバーをChatGPTに接続するには：

1. ChatGPTで「Quicknode」アプリにアクセスするか、ChatGPTを開いてサイドバーの「アプリ」に移動し、「Quicknode」を検索してください。
2. Quicknodeアプリのページで「接続」をタップしてください
3. ブラウザウィンドウが開きます。 mcp.quicknode.com Quicknodeアカウントでログインし、役割を選択して（管理者 または ビューアー)、およびアクセスを承認する
4. ChatGPTでの会話で、Quicknodeが利用可能になりました。チャット内で@Quicknodeをメンションすると利用できます

コーデックス

Codex（OpenAI）にQuicknodeを追加するには：

1. Codexを開いて、次のように入力してください /plugin 入力欄で
2. 利用可能なプラグインを閲覧し、「Quicknode」を選択してください
3. Enterキーを押して詳細を表示し、「プラグインをインストール」を選択してください
4. まだChatGPT経由で接続していない場合は、OAuth認証用のブラウザウィンドウが開きます。そこでQuicknodeアカウントでログインし、役割（管理者または閲覧者）を選択して、アクセスを承認してください。
5. インストール後、Codexのセッション内でQuicknodeツールが利用可能になります

ヒント

ChatGPTですでにQuicknodeを連携済みの場合は、認証手順は省略され、プラグインはすぐに利用可能になります。

カーソル

Quicknode MCP サーバーを Cursor に追加するには：

1. 「設定」＞「ツールとMCP」に移動し、「新しいMCPサーバー」をクリックします
2. （任意）開く（または作成する） .cursor/mcp.json プロジェクトのルートディレクトリまたはホームディレクトリ内に
3. 以下の設定を追加してください：

{
  "mcpServers": {
    "quicknode": {
      "url": "https://mcp.quicknode.com/mcp"
    }
  }
}

4. ファイルを保存すると、Cursorは新しいサーバー設定を自動的に検出します。
5. Cursor インターフェースで、Quicknode MCP サーバーの横にある[Connect] をクリックします
6. ブラウザウィンドウが開き、そこでQuicknodeアカウントでログインして、アクセスを承認することができます

VS Code

Quicknode MCP サーバーを VS Code（GitHub Copilot）に追加するには：

1. コマンドパレットを開きます（Cmd+Shift+P / Ctrl+Shift+P)
2. 「MCP: サーバーの追加」を検索
3. サーバーの種類として「HTTP」を選択してください
4. URLを入力してください： https://mcp.quicknode.com/mcp
5. 「ユーザー設定」（グローバル）に保存するか、「ワークスペース設定」（プロジェクト限定）に保存するかを選択してください

あるいは、これをあなたの .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "quicknode": {
        "type": "http",
        "url": "https://mcp.quicknode.com/mcp"
      }
    }
  }
}

ウィンドサーフィン

Quicknode MCP サーバーを Windsurf に追加するには：

1. 「ウィンドサーフの設定」＞「カスケード」＞「MCP」＞「サーバーの追加」＞「カスタムサーバーの追加」を開きます
2. これで開きます ~/.codeium/windsurf/mcp_config.json. 追加：

{
  "mcpServers": {
    "quicknode": {
      "serverUrl": "https://mcp.quicknode.com/mcp"
    }
  }
}

3. 設定の「MCP」セクションにある更新ボタンをクリックして有効にしてください

Zed

Quicknode MCP サーバーを Zed に追加するには：

1. 開く 設定 (Cmd+, / Ctrl+,)
2. 以下の内容をあなたの settings.json:

{
  "context_servers": {
    "quicknode": {
      "transport": "http",
      "url": "https://mcp.quicknode.com/mcp"
    }
  }
}

3. Zedを再起動してサーバーを起動してください

その他のクライアント

その他のMCP対応クライアントについては、以下の接続情報を使用してください：

• URL： https://mcp.quicknode.com/mcp
• 転送方式：ストリーミング対応HTTP
• 認証：OAuth 2.1（初回接続時に自動的に処理されます）

クライアントがOAuthやHTTPトランスポートをネイティブでサポートしていない場合は、以下を使用できます。 mcp-remote 橋として：

{
  "mcpServers": {
    "quicknode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quicknode.com/mcp"]
    }
  }
}

認証とロール

初めて接続すると、Quicknodeアカウントでログインするためのブラウザウィンドウが開きます。複数のQuicknodeアカウントをお持ちの場合は、接続するアカウントを選択します。その後、MCPサーバーがユーザーに代わって実行できる操作を決定するAPIキーの役割を選択します：

• 管理者— 完全な読み取りおよび書き込み権限。これにより、AIアシスタントはエンドポイントの作成や削除、セキュリティルールの変更、レート制限の更新、およびすべてのアカウントリソースの管理を行うことができます。
• Viewer— 読み取り専用アクセス権限。アシスタントは、エンドポイントの一覧表示、メトリクス、ログ、使用状況、および課金データの閲覧が可能ですが、リソースの作成、変更、削除は行えません。

この処理により、内部で、選択したロールにスコープが設定されたAPIキーが生成されます。ユーザー自身がキーを作成したり管理したりする必要はありません。

適切な役割の選び方

インフラストラクチャの確認のみを行う場合は、「Viewer」ロールを選択してください。「Admin」ロールは、アシスタントに変更を行わせる必要がある場合にのみ使用してください。後でロールを切り替える必要がある場合は、クライアントからサーバーを削除し、再度追加してから、認証フローを再度実行して、別のロールで再認証を行ってください。

APIキーの使用

ブラウザベースのログインが不可能な非対話型環境（CI/CDパイプライン、リモートVM、自動化エージェントなど）で実行している場合は、APIキーをベアラートークンとして渡すことで、OAuthフローをスキップできます。MCPサーバーは、 承認 ヘッダーを参照し、そのリクエストをすでに認証済みとして扱います。

Quicknodeダッシュボードの「アカウント」（アバターアイコン）＞「APIキー」からAPIキーを生成してください。キーに割り当てるロール（「管理者」または「閲覧者」）によって、MCPサーバーの権限が決まります。これは、OAuthフロー中にロールを選択する場合と同じです。

クロード

クロード・コード

APIキーをベアラー・トークンとして、以下の方法を使用して渡してください。 --ヘッダー flag:

claude mcp 追加 quicknode --transport http https://mcp.quicknode.com/mcp --ヘッダー "Authorization: Bearer YOUR_API_KEY"

Claude デスクトップ

「」を追加します。 --ヘッダー フラグを mcp-remote あなたの claude_desktop_config.json:

{
  "mcpServers": {
    "quicknode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quicknode.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

OpenAIOpenAI

コーデックス

APIキーをベアラー・トークンとして、以下の方法を使用して渡してください。 --bearer-token-env-var flag。これは、実行時に環境変数からキーを読み取るようCodexに指示するものです：

codex mcp 追加 quicknode \
  --url https://mcp.quicknode.com/mcp \
  --bearer-token-env-var YOUR_API_KEY

実行 codex mcp リスト サーバーが登録されていることを確認するため。

カーソル

以下の内容をあなたの .cursor/mcp.json:

{
  "mcpServers": {
    "quicknode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quicknode.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

VS Code

「」を追加します。 ヘッダー フィールドをあなたの .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "quicknode": {
        "type": "http",
        "url": "https://mcp.quicknode.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
}

ウィンドサーフィン

「」を追加します。 ヘッダー フィールドをあなたの ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "quicknode": {
      "serverUrl": "https://mcp.quicknode.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Zed

「」を追加します。 ヘッダー フィールドをあなたの settings.json:

{
  "context_servers": {
    "quicknode": {
      "transport": "http",
      "url": "https://mcp.quicknode.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

その他のクライアント

カスタムヘッダーをサポートするクライアントについては、以下を設定してください：

認証情報: Bearer YOUR_API_KEY

クライアントが mcp-remote, に --ヘッダー flag:

{
  "mcpServers": {
    "quicknode": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.quicknode.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

利用可能なツール

MCPサーバーは、Admin APIを通じて以下のツールを提供しています。「読み取り専用」とマークされたツールは、Adminロールと Viewer ロールの両方で利用可能です。それ以外のすべてのツールを利用するには、Adminロールが必要です。

エンドポイント管理

サポートされているあらゆるチェーンおよびネットワークにおいて、Quicknodeエンドポイントの作成、読み取り、更新、削除を行うことができます。

ツール	説明	アクセス
エンドポイント一覧	アカウント上のすべてのエンドポイントを一覧表示する	読み取り専用
get-endpoint	特定のエンドポイントの詳細を取得する	読み取り専用
エンドポイントの作成	指定されたチェーンおよびネットワーク上に新しいエンドポイントを作成する	admin
エンドポイントの削除	エンドポイントを削除する	admin
get-endpoint-metrics	エンドポイントのパフォーマンス指標を取得する	読み取り専用
エンドポイントログの一覧	エンドポイントの最新のログを取得する	読み取り専用
get-endpoint-log-details	特定のログエントリに関する詳細情報を取得する	読み取り専用

レート制限

メソッドレベルおよびエンドポイントレベルのリミットを設定します。

ツール	説明	アクセス
エンドポイントのレート制限の更新	エンドポイントに対する全体的なレート制限（RPS、RPM、RPD）を設定する	admin
リスト・エンドポイント・メソッド・レート制限	メソッドごとのレート制限の一覧	読み取り専用
エンドポイント・メソッド・レート制限の作成	特定のRPCメソッドにレート制限を追加する	admin
エンドポイント・メソッド・レート制限の更新	既存のメソッドのレート制限を更新する	admin
エンドポイント・メソッドのレート制限の削除	メソッドのレート制限を解除する	admin

セキュリティ

エンドポイントの認証およびアクセス制御の設定を管理します。 セキュリティルールの作成 そして セキュリティルールの削除 このツールは、IP許可リスト、JWT検証、リファラー制限、ドメインマスク、認証トークンなど、複数のルールタイプに対応しています。

ツール	説明	アクセス
リスト・エンドポイント・セキュリティ	現在のセキュリティ設定とルールを確認する	読み取り専用
エンドポイントセキュリティオプションの更新	セキュリティ機能（CORS、HSTS、IPフィルタリングなど）を有効または無効にする	admin
セキュリティルールの作成	セキュリティルール（IP、JWT、リファラー、ドメインマスク、またはトークン）を追加する	admin
セキュリティルールの削除	セキュリティルールを削除する	admin

利用方法と請求について

RPCの使用状況を監視し、請求情報を確認します。

ツール	説明	アクセス
get-rpc-usage	RPCの使用状況を、エンドポイント、メソッド、またはチェーンごとの内訳（任意）とともに取得する	読み取り専用
get-billing	請求書や支払い履歴を確認する	読み取り専用

チェーン

利用可能なチェーンとネットワークを照会する。

ツール	説明	アクセス
リストチェーン	サポートされているすべてのチェーンと、それらの利用可能なネットワークを一覧表示する	読み取り専用

MCPリソース

ツールに加え、Quicknode MCP サーバーはエンドポイントを MCPのリソース. リソースを使用すると、AIアシスタントは、まずツールを呼び出す必要なく、コンテキスト内でエンドポイントの詳細を直接参照できるようになります。MCPリソースをサポートするクライアントでは、次のように入力できます。 @quicknode エンドポイントを閲覧し、会話に添付するには（例： quicknode://endpoints/<endpoint-id>).

これは、特定チェーンを対象としたコードの記述やリクエストのデバッグなど、タスクに取り組んでいる際に、アシスタントがエンドポイントの設定をすぐに参照できるようにしたい場合に便利です。

プロンプトの例

ツール名を直接指定する必要はありません。AIアシスタントが、自然言語を適切なツールに紐付けます。例をいくつか挙げます：

エンドポイント管理：

• 「新しいBaseメインネットのエンドポイントを作成する」
• 「私のすべてのエンドポイントとその現在のステータスを表示してください」

監視とデバッグ：

• 「過去1時間の私のArbitrumエンドポイントのログを確認してください」
• 「過去1週間の私のイーサリアムエンドポイントのパフォーマンス指標を見せてください」

セキュリティ：

• 「イーサリアムメインネットのエンドポイントにJWT認証を追加する」
• 「すべてのエンドポイントのセキュリティ設定を確認する」

利用方法および請求について：

• 「今月のチェーンごとのRPC使用状況の内訳を表示してください」
• 「今月、どのエンドポイントが最も多くのクレジットを使用していますか？」

レート制限：

• 「自分のPolygonエンドポイントのリクエスト制限を1秒あたり100件に設定する」
• 「eth_call に対してメソッド固有のレート制限を追加する」

ヒント

• まずは簡単なことから始めましょう。「どのエンドポイントがあるか？」や「今月の利用状況を見せて」などと尋ねてみて、利用可能なツールに慣れてみましょう。
• 具体的に指定してください— エンドポイントが複数ある場合は、アシスタントが正しいものを素早く見つけられるよう、チェーン名や名前を明記してください。

仕組み

MCPサーバーは、以下の場所でリモートホストされています。 https://mcp.quicknode.com/mcp また、認証にはOAuth 2.1を採用しています。AIアシスタントがQuicknodeのインフラに関連するリクエストを受信すると、適切なMCPツールを呼び出し、そのツールがQuicknode Admin APIに対して認証済みのリクエストを送信します。アシスタントは応答のフォーマット処理を行い、結果を自然言語で表示します。

書き込み操作（エンドポイントの作成、セキュリティ設定の変更、リソースの削除）を実行するには、「Admin」ロールが必要であり、アシスタントが操作を実行する前に、ユーザーによる明示的な確認が必要です。「Viewer」ロールで接続している場合、アシスタントは読み取り専用の操作のみ実行できます。

ヒント

Quicknode MCPは、アカウントレベルのインフラストラクチャを管理します。AIコーディングエージェントがコードを記述する際に、QuicknodeのAPIや製品に関する正確な知識を備えてほしい場合は、「Blockchain Skills」をご覧ください。AIに最適化されたドキュメント検索については、「LLM-Optimized Docs」をご覧ください。

リソース

Claude上のQuicknodeコネクタ

Anthropic MCPのディレクトリから直接Quicknodeを追加する

→

セットアップガイド

AIとMCPを活用してブロックチェーンインフラを管理する

→

ChatGPT上のQuicknode

ChatGPTのアプリカタログから直接、Quicknodeアプリをインストールしてください

→

管理用 API ドキュメント

Quicknode 管理用 API リファレンス

→

EVM MCP サーバー

EVM MCP サーバーの使用ガイド

→

Solana MCP サーバー

Solana MCP サーバーの使用ガイド

→

皆様からのフィードバックを心よりお待ちしております！❤️

このドキュメントについてご意見やご質問がございましたら、ぜひお知らせください。皆様からのご連絡を心よりお待ちしております！