コンテンツへスキップ

ecentic MCP サーバー。

Claude、ChatGPT、その他あらゆるModel Context Protocolクライアントは、JSON-RPC 2.0経由でecenticをネイティブに呼び出せます。このページでは、エンドポイント、トランスポート、ハンドシェイク、および公開されているすべてのツールを含む接続仕様を説明します。

Streamable HTTP · JSON-RPC 2.0 · 7つのツール

01

接続

1つのエンドポイント、2つのパス、管理するセッションはありません。

接続リファレンス

プライマリエンドポイント
POST https://ecentic.ai/mcp
同一ハンドラー
POST https://ecentic.ai/api/mcp
POST https://ecentic.ai/mcp

サーバーは/mcpと/api/mcpの両方で利用できます。どちらも同じハンドラーです。多くのクライアントやスキャナーがまずこちらを探索するため、短いパスも用意されています。

02

ハンドシェイク

initializeを実行し、その後initialized通知を送信します。

ハンドシェイクを確認

  1. 01

    初期化

    クライアントが送信
    initialize
    サーバーが返す内容
    200

    ネゴシエート済みプロトコルとサーバー機能

    initializeは、ネゴシエートされたプロトコルバージョン、サーバー識別情報、対応機能、およびecenticの用途を説明するinstructions文字列を返します。ecenticが対応するバージョンを要求した場合はそのバージョンが返され、それ以外はサーバーが公開しているバージョンへフォールバックします。

  2. 02

    通知

    クライアントが送信
    notifications/initialized
    サーバーが返す内容
    202

    空の本文で受理

    続くnotifications/initializedメッセージはJSON-RPCのnotificationであり、idを持たずレスポンスも返りません。ecenticはトランスポート仕様に従い、空ボディの202 Acceptedを返します。notificationに対してJSON-RPCエラーを返すサーバーはハンドシェイクを破壊するため、クライアントが接続できない場合はまずこのやり取りを確認してください。

完全なハンドシェイク例
initializeで受け付けるプロトコルバージョン
03

ツール

サーバーが公開している内容と、キーが必要な呼び出しを示します。

04

認証

読み取り専用ツールは公開されています。アカウントに触れる操作にはbearerキーが必要です。

Bearer key を送信

コード例

アカウント状態を変更するツール呼び出しではAuthorization: Bearer ecentic_sk_…を送信してください。認証情報が必要なのに存在しない呼び出しでは、Protected Resource Metadataドキュメントを示すWWW-Authenticateヘッダー付きのHTTP 401が返されるため、クライアントは失敗レスポンスから再度ディスカバリーを実行できます。

認証情報を作成

キーはセルフサービスで発行できます。アカウント作成後、ダッシュボードまたは認証済みセッション上でcreate_api_keyを呼び出して発行してください。どの段階でも営業担当への連絡は不要です。

05

エラー

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ヘッダーも含みます。

このページのすべての記述は検証可能です。マニフェスト、サーバーカード、OpenAPIドキュメントはすべて同じエンドポイントを説明しています。