ecentic MCP サーバー。
Claude、ChatGPT、その他あらゆるModel Context Protocolクライアントは、JSON-RPC 2.0経由でecenticをネイティブに呼び出せます。このページでは、エンドポイント、トランスポート、ハンドシェイク、および公開されているすべてのツールを含む接続仕様を説明します。
Streamable HTTP · JSON-RPC 2.0 · 7つのツール
接続
1つのエンドポイント、2つのパス、管理するセッションはありません。
接続リファレンス
- プライマリエンドポイント
- POST https://ecentic.ai/mcp
- 同一ハンドラー
- POST https://ecentic.ai/api/mcp
サーバーは/mcpと/api/mcpの両方で利用できます。どちらも同じハンドラーです。多くのクライアントやスキャナーがまずこちらを探索するため、短いパスも用意されています。
トランスポートはStreamable HTTPです。すべてのリクエストはJSON-RPC 2.0を含むPOSTで送信され、レスポンスも同じPOSTに返されます。ecenticはサーバー主導のストリームを開始しないため、Accept: text/event-stream付きのGETには、出力されないストリームでクライアントを待機させる代わりに405を返します。
セッションは存在しません。ecenticはMcp-Session-Idを発行せず、セッション終了用のDELETEにも同じ理由で405を返します。破棄すべき状態はありません。
ハンドシェイク
initializeを実行し、その後initialized通知を送信します。
ハンドシェイクを確認
- 01
初期化
- クライアントが送信
- initialize
- サーバーが返す内容
- 200
ネゴシエート済みプロトコルとサーバー機能
initializeは、ネゴシエートされたプロトコルバージョン、サーバー識別情報、対応機能、およびecenticの用途を説明するinstructions文字列を返します。ecenticが対応するバージョンを要求した場合はそのバージョンが返され、それ以外はサーバーが公開しているバージョンへフォールバックします。 - 02
通知
- クライアントが送信
- notifications/initialized
- サーバーが返す内容
- 202
空の本文で受理
続く
notifications/initializedメッセージはJSON-RPCのnotificationであり、idを持たずレスポンスも返りません。ecenticはトランスポート仕様に従い、空ボディの202 Acceptedを返します。notificationに対してJSON-RPCエラーを返すサーバーはハンドシェイクを破壊するため、クライアントが接続できない場合はまずこのやり取りを確認してください。
ツール
サーバーが公開している内容と、キーが必要な呼び出しを示します。
認証
読み取り専用ツールは公開されています。アカウントに触れる操作にはbearerキーが必要です。
Bearer key を送信
アカウント状態を変更するツール呼び出しではAuthorization: Bearer ecentic_sk_…を送信してください。認証情報が必要なのに存在しない呼び出しでは、Protected Resource Metadataドキュメントを示すWWW-Authenticateヘッダー付きのHTTP 401が返されるため、クライアントは失敗レスポンスから再度ディスカバリーを実行できます。
認証情報を作成
キーはセルフサービスで発行できます。アカウント作成後、ダッシュボードまたは認証済みセッション上でcreate_api_keyを呼び出して発行してください。どの段階でも営業担当への連絡は不要です。
エラー
2種類のエラーレイヤーと、現在どちらを見ているか。
JSON-RPCエラー
error.code
JSON-RPCエラー — 不明なメソッド、不正なパラメータ、実行を拒否したツールなど — は、JSON-RPC仕様どおりerrorメンバー付きHTTP 200として返されます。error.codeで条件分岐してください。
トランスポートエラー
application/problem+json
トランスポートエラー — エンドポイントが提供していないメソッドなど — は、Content-Type: application/problem+jsonと機械可読なcodeを持つRFC 9457のエラードキュメントとして返されます。これはRESTインターフェースと同じエラーモデルです。
認証例外
WWW-Authenticate
唯一の例外は401です。JSON-RPCを既に解析しているクライアントが別パーサーを必要としないよう、JSON-RPCエンベロープを返しつつ、ディスカバリー用のWWW-Authenticateヘッダーも含みます。