Skip to content
AlumiaDocs

Search docs

Find pages, headings, and concepts. Press ⌘K or Ctrl+K to toggle.

MCP servers

Register org MCP servers for agent tool access (distinct from hosted alumia.com/mcp).

Open in ChatGPTOpen in Claude

Org-registered MCP servers differ from the hosted Alumia MCP endpoint documented in Connect via MCP.

Creating, updating, deleting, or probing org MCP servers requires an owner/admin browser session with fresh step-up. API keys are rejected with 403 "MCP server management requires a browser session".

Endpoints

MethodPathDescription
GET/api/v1/mcp/serversList servers.
POST/api/v1/mcp/serversRegister a server (URL + auth).
GET/api/v1/mcp/servers/:idFetch config (secrets masked).
PATCH/api/v1/mcp/servers/:idUpdate server.
DELETE/api/v1/mcp/servers/:idRemove server.
POST/api/v1/mcp/servers/:id/testProbe connectivity.