references/features/mcp-servers.md
references/features/mcp-servers.mdBrowse 27 files
290 tokens
1,097 bytes
Token encoding: o200k_base
Snapshot 8beb6cd
← Back to SKILL.md
MCP servers
User-added MCP servers and the OAuth clients they mint.
How to get there
/account/mcp-servers → /account/mcp-servers/new →
/account/mcp-servers/:serverId. Clients: /account/mcp-oauth-clients.
Drive it
node tools/control-kody.ts request GET /account/mcp-servers.json
node tools/control-kody.ts request GET /account/mcp-oauth-clients.json
APIs
GET|POST /account/mcp-servers.jsonGET|POST /account/mcp-oauth-clients.json/account/mcp-servers/oauth/callback
Gotchas
- App
/mcp(Kody-as-server) is a different surface. Unauthenticated GET is 401 by design. - After IdP success, Status on
/account/mcp-servers/:serverIdshows a sanitized last settle error when tool discovery does not finish (including after a 2025 handshake retry). When a ready connection parks onauthenticating, Status andmcpServerList.errorinclude the sanitized token-refresh reason.mcpServerListalso reportshasRefreshToken. Reconnect tries the stored tokens first, then mints a new authorization link. Reconnect from that page.