MCP connections
The MCP server for AI apps (docs/mcp.md): the connection window an app signs in through, and the apps connected. None of it is reachable over MCP itself.
Reading needs Read only and changes need Full, unless an endpoint says otherwise. How to read this page.
GET /api/mcp
Section titled “GET /api/mcp”Whether MCP is on, its URL, the connection window, the connected apps and their recent calls.
- Level: Read only
- Notes: Not over MCP
- Returns:
{enabled, unavailable, url, window, connections[], activity[]}
POST /api/mcp/connect-window
Section titled “POST /api/mcp/connect-window”Open ten minutes in which one app may register and you may approve it; browser session only.
- Level: Full
- Notes: Not over MCP
- Returns:
{window}
DELETE /api/mcp/connect-window
Section titled “DELETE /api/mcp/connect-window”Close the connection window; browser session only.
- Level: Full
- Notes: Not over MCP
DELETE /api/mcp/connect-window/registration
Section titled “DELETE /api/mcp/connect-window/registration”Forget the app that registered in your window and keep the window open; browser session only.
- Level: Full
- Notes: Not over MCP
PATCH /api/mcp/connections/:id
Section titled “PATCH /api/mcp/connections/:id”Change a connected app’s access; its very next call has the new level.
- Level: Full
- Notes: Not over MCP
- Input:
{access: "read"|"manage"|"full"} - Returns:
{connection}
DELETE /api/mcp/connections/:id
Section titled “DELETE /api/mcp/connections/:id”Disconnect an app: its tokens stop working at once.
- Level: Full
- Notes: Destructive · Not over MCP
POST /api/oauth/authorize/check
Section titled “POST /api/oauth/authorize/check”What the approval page shows for an app asking to connect; browser session only.
- Level: Full
- Notes: Not over MCP
- Input:
{query} - Returns:
{status: "ready"|"closed"|"error", ...}
POST /api/oauth/authorize/decision
Section titled “POST /api/oauth/authorize/decision”Approve or decline the app at the level chosen; browser session only.
- Level: Full
- Notes: Not over MCP
- Input:
{query, approve, access?: "read"} - Returns:
{redirectTo}