エージェントを接続する
MCP対応のAIエージェントフレームワークをEdison Watchゲートウェイに向ける - URLひとつ、ヘッダー設定不要。あらゆるフレームワーク向けクイックスタートの基本となる接続ガイド。
Claude や ChatGPT のようなパッケージ済みアプリを接続するのではなく、独自のエージェントを構築している場合は、リモートMCPサーバーへの接続と同じ方法でEdisonに接続します。フレームワークの MCPクライアント をEdison ゲートウェイURLに向けるだけです。有効にしたすべてのサーバーのすべてのツールが通常のMCPツールとして表示され、エージェントが行うすべての呼び出しはリアルタイムで監視・ポリシー適用されます。
このページは 基本接続ガイド です。このセクションの各フレームワーク向けクイックスタートは、ここに書かれている内容の薄いラッパーです。一度読んだら、ご自身のフレームワークへ進んでください。
理解すべきたった一つのこと：認証情報はURLの中にある
EdisonはMCP接続に Authorization ヘッダーを 使用しません。APIキーは接続URL自体の セグメント です。
https://mcp.edison.watch/mcp/<your-api-key>/?client=<label>
└──────────┬───────────┘└─┬─┘└─────┬──────┘└┬┘└──────┬──────┘
gateway host fixed your API key │ optional session
(per-org, see below) prefix (edison_...) │ label for the
trailing slash dashboard
(required)streamable-HTTP MCP接続をURLに開けるものなら何でもEdisonに接続できます。カスタムヘッダーも、OAuthクライアントも、トークン交換も不要です。これにより、Edisonはほぼすべてのエージェントフレームワーク（リクエストヘッダーをまだ設定できない多くのフレームワークを含む）と互換性があります。
MCPクライアントに Authorization: Bearer ヘッダーを追加しないでください - EdisonはURLパスからのみキーを読み取るため、Bearerヘッダーはここでは機能しません。（Edisonは /api/v1/... の管理REST APIに対して Authorization: Bearer を使用しますが、それはMCP接続とは別の部分です。）
1. 接続URLを取得する
個人URLにはAPIキー（形式：edison_ に続く約40文字）が埋め込まれています。Edison Watchダッシュボード から取得してください。Settings を開き、Api key / MCP URL セクションを見つけ、Get MCP URL をクリックします。Edison Watch デスクトップアプリ の Copy MCP URL メニューからベースURLをコピーすることもできます。
ゲートウェイホストは環境ごとに異なります。リリース版は mcp.edison.watch、デモおよびセルフホスト環境は独自のホストを使用します。mcp.edison.watch をハードコードするのではなく、常に ご自身の ダッシュボードまたはデスクトップアプリからURLをコピーしてください。
コードにキーが直接含まれないよう、環境変数として保存してください。
export EDISON_MCP_URL="https://mcp.edison.watch/mcp/edison_your_key_here/?client=my-agent"オプションの ?client=<label> サフィックスを付けると、Edisonダッシュボード上でセッションにタグが付き、このエージェントのトラフィックを他のコネクタと区別できます。任意の短いラベルを使用してください（my-agent、langgraph-prod など）。
2. フレームワークを向ける
このセクションの各フレームワークは、同じ操作に集約されます。EDISON_MCP_URL をそのフレームワークの streamable-HTTP MCPクライアント に渡し、ツールを自動検出させるだけです。公式MCP SDKを使用したPythonの生の形式を以下に示します。上位レベルのフレームワークはすべてこれをラップしています。
import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
async def main():
url = os.environ["EDISON_MCP_URL"]
async with streamablehttp_client(url) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
print([t.name for t in tools.tools]) # tools from every enabled serverheaders= 引数がないことに注意してください。認証情報はすでに url の中にあります。慣用的な記述については、以下のフレームワークを選択してください。
Edisonのゲートウェイは streamable-HTTP のみを提供します。フレームワークでトランスポートを選択するよう求められた場合は、streamable-HTTP（http または streamable_http と表記されることもあります）を選択してください。SSEはMCP仕様で非推奨となっており、ゲートウェイでは提供されていません。
フレームワークを選択する
OpenAI Agents SDK
Python & TypeScript。OpenAIの公式マルチエージェントSDK。
Claude Agent SDK
Python & TypeScript。Claude Codeを支えるAnthropicのエージェントSDK。
LangChain / LangGraph
Python & JS。最大のエージェントエコシステム。
Pydantic AI
Python。型安全なPydanticネイティブエージェント。
LlamaIndex
Python & TS。データ・検索中心のエージェント。
Google ADK
Python。GeminiのためのGoogleのAgent Development Kit。
Microsoft Agent Framework
Python & .NET。Semantic Kernel + AutoGenの後継。
Vercel AI SDK
TypeScript。AIアプリ開発者に最も普及したSDK。
Mastra
TypeScript。バッテリー同梱のTSエージェントフレームワーク。
DSPy
Python。言語モデルをプロンプトではなくプログラムで操作。
暗号化シークレット
一部の有効化されたサーバーは ゼロ知識暗号化シークレット を使用します。ゲートウェイがそれらを復号できるよう、クライアントはオプションの x-edison-secret-key ヘッダーを送信できます。これはAPIキーとは別のもので、カスタムリクエストヘッダーを設定できるフレームワークでのみ使用できます。このヘッダーがなくてもEdisonは接続しますが、暗号化シークレットが必要なサーバーのみ復号に失敗します。各フレームワークのページに設定場所が詳しく示されています。