セットアップ

MCP client へ https://mcp.epismo.ai/ を Streamable HTTP server として追加します。authentication は mcp scope の OAuth です。MCP endpoint は、Epismo authorization server を示す protected-resource metadata を公開します。

GET https://mcp.epismo.ai/.well-known/oauth-protected-resource
GET https://api.epismo.ai/.well-known/oauth-authorization-server

準拠 client はこれらを discover し、必要に応じて register し、PKCE 付き Authorization Code を使い、必要最小限の scope を request します。access token を プレイブック、案件 input、記録、URL、chat prompt へ貼り付けないでください。

hosted server は stateless です。HTTP request ごとに fresh transport を作り、Mcp-Session-Id を発行しません。client は session affinity に依存できません。transport session ではなく、tool result と Epismo ID が durable な continuation mechanism です。

接続後に epismo://context/current_user を読み、workspace 利用時は epismo://context/teams も読みます。エージェントが ACL や assignment を作る前に、OAuth token がどの User・workspace を表すか確認できます。

正確な input field は server 公開の tool schema が authoritative です。全 mutation は idempotency UUID を受け取り、既存 案件・タスク の mutation には最新の expectedLockVersion が必要です。