Ravex-mcp-server

Ravex-mcp-server は、検証済みの Partner API ツールを MCP 互換の AI エージェントに公開します。

設定

RAVEX_API_KEY=rk_test_...
RAVEX_API_BASE_URL=https://sandbox.api.ravexapp.com/api/partner/v1
PORT=8787

リモートの HTTP クライアントの場合は、MCP リクエストの Authorization ヘッダーに Ravex ベアラートークンを送信します。サーバーはトークンをツールの説明やモデルコンテキストに含めることはありません。

Related MCP server: nice

実行

npm install
npm run build
RAVEX_API_KEY=rk_test_... npm start

Streamable HTTP エンドポイントは /mcp です。stdio をサポートするローカルクライアントの場合は:

RAVEX_API_KEY=rk_test_... node dist/server.js --stdio

MCP クライアントの設定

このサービスを HTTPS の背後にデプロイした後、デプロイした URL で MCP クライアントを設定します:

{
  "mcpServers": {
    "ravex": {
      "url": "https://<your-mcp-host>/mcp",
      "headers": {
        "Authorization": "Bearer rk_test_..."
      }
    }
  }
}

実際のキーをこの設定にコミットしないでください。マルチユーザーホスティングの場合は、サーバー側の RAVEX_API_KEY を省略し、各クライアントが独自のベアラートークンを送信することを要求します。サービスはそのトークンを Ravex Partner API にのみ転送します。

書き込みツールには一意の idempotency_key が必要です。ホストは、それらを呼び出す前にユーザーの確認を要求する必要があります。リクエストが成功してもステータスが processing のままの場合があります。エージェントは、Ravex のウェブフックまたはホストアプリケーションでのステータス照会を通じて調整する必要があります。