An MCP server in Command lets external AI tools — Claude Desktop, ChatGPT, Cursor, n8n — search the documents in the projects you choose, read-only, over the Model Context Protocol. Each server has its own URL, its own key, and its own project allow-list.
In this section
- Create a server, scope it to projects, and copy the key (shown once).
- Connect a tool with a Bearer API key or OAuth 2.1 discovery.
- Understand the four read-only tools and their filters.
- Rotate or revoke access when a tool or teammate changes.
What's inside
- 01
Creating a server
Settings → MCP Servers → New server. Pick the projects it can search and copy the API key — it is displayed once. Only org owners and admins can create, edit, rotate, or delete servers. Create separate servers for separate use-cases; projects can be added or removed at any time.
- 02
Connecting a tool
API key (Bearer token) is simplest — send Authorization: Bearer <key>; best for n8n, scripts, and Cursor. OAuth 2.1 uses the discovery URL shown in the server details and suits Claude Desktop and ChatGPT custom connectors.
- 03
Filters
Both search tools accept optional project_ids, folder_ids, labels, and label_match ('any' by default, 'all' to require every label). Filters only narrow results inside the projects the server may already read.
- 04
Prompting tips
Tell the external agent: use search_metadata when the user asks about a specific file, search_files when they ask what documents say about a topic, call get_project_information first when the project is ambiguous, and always cite the returned file_id and project id.
- 05
Rotating and revoking
Rotate issues a new key and stops the old one. Deleting a server cuts every tool connected through it immediately.
At a glance
| Tool | What it returns | Best for |
|---|---|---|
| get_project_information | Allowed projects with id, name, description, timestamps, file count, and direct URL. | Resolving which project the user means |
| list_files | Files in one or more allowed projects, optionally by folder. | Seeing what exists before searching |
| search_metadata | Keyword search over title, filename, summary, context, and labels. | Finding a named file or tagged set |
| search_files | Keyword search over full Markdown text with a snippet around the best hit. | Content questions across documents |
Read-only
MCP servers cannot upload, modify, or delete anything in Command. They only read the projects on their allow-list.