Search MCP lets apps such as Claude, Codex, and Cursor search your organization's sources and read results. MCP (Model Context Protocol) connects an app to tools. Each person signs in to Sim; their current membership, provider access, and source restrictions apply.
Connect an app
First confirm you can find a document in the organization's Search. Connect your source account if required.
- Open Settings → Search MCP in the organization view.
- Select your App and copy its displayed URL, command, or configuration.
- Add it in your app using the instructions below, sign in to Sim, and approve Search access. Each teammate signs in separately; this flow needs no API key.
These are common client setups. Use the instructions displayed in Sim for other listed apps.
Claude's hosted connectors reach Sim from Anthropic's servers. Your deployment must be publicly reachable from those servers; a localhost URL will not work. Claude network requirements.
Search and read
Ask your app: “Use Sim Search to find our launch checklist, read it, and cite the source.” It can use these tools:
Keep each opaque documentId unchanged: it binds the result to the reader, account, source, and organization. Titles and raw provider IDs are not substitutes. Cite the returned citationUrl when available.
Batch reads start each document at the beginning. Use documentId with the returned offsets to continue one document; batch documentIds cannot include offsets. An unreadable document returns its own error while other reads can succeed. Each document counts separately against read rate limits.
The tools do not edit source content. Sim policy and usage limits apply to chat.
Limits
A search query can be empty with date bounds, newest/oldest sorting where supported, or an explicit native browse mode. Provider filtering and limits may return fewer matches or chunks. Continue with the provider's cursor on the same query and account; for multiple native queries, match the status's queryIndex to the query being continued. An empty page does not prove complete coverage. Follow the read's next object instead of calculating offsets.
API rate limits apply; follow the returned retry delay. Provider failures and incomplete retrieval are explicit. The tools do not fall back to a stored index when a provider is unavailable.
Reconnect or revoke access
The connection applies to the organization whose URL you copied. It does not add sources, connect provider accounts, or grant extra access. Search and reads recheck membership, settings, and provider permissions.
If sign-in expires, reconnect in your app. To revoke its Sim authorization, open Settings → General → Authorized apps, find the app, and revoke it. This blocks future requests but does not remove content already returned to the app.
If MCP is unavailable, ask an admin to check Search availability and MCP policy. For missing results, check the same query in Sim Search, your provider connection, and source settings.
Related docs
- Connect your account
- Workspace MCP tools — connect external servers to Sim agents
- Workflow MCP deployment — expose workflows as tools
Workspace and workflow MCP setups do not automatically add workspace content to organization Search.