bigRAG
API Reference

MCP Servers

Mint and manage Model Context Protocol server credentials for Claude Desktop, Cursor, and other MCP clients.

Base path: /v1/admin/mcp-servers — Session-only (admin UI).

Each MCP server is an API key with extra metadata (title, server_name, optional collection scope). MCP keys are read/query-only by default with collection:read, document:read, and query:read. They reuse the same ApiKey row, auth, scope, and audit machinery as ordinary API keys — but /v1/admin/api-keys filters MCP-tagged keys out to keep that list clean.

A delete on the underlying API key cascades through. Generic API keys and MCP servers share a uniqueness constraint on key_hash.

See also

  • MCP usage guide — wire a server into Claude Desktop, Cursor, or a custom client.
  • API Keys — the underlying credential primitive.

On this page