Connect Orvo to Zed

Who this is for

Zed users who want stakeholder context, notes and follow-ups available to the Zed agent.

Before you start

• An up-to-date Zed on macOS, Windows or Linux. Sign-in for remote MCP servers arrived in spring 2026, so update if you don’t see an Authenticate button.
• A model for Zed’s agent: Zed’s hosted models (Pro plan) or your own API key under Settings → AI → LLM Providers.
• An Orvo account with web access (the free trial works).

Your Orvo MCP server URL.

Option 1: sign in with Orvo (recommended)

1. Open Settings → AI → MCP Servers (or run agent: open settings and pick MCP Servers).
2. Click Add Server, then Add Remote Server, and enter orvo with the URL https://www.getorvo.com/api/mcp.
3. Zed saves it in your settings.json. You can also add it there yourself:
   settings.json Copy

   {
     "context_servers": {
       "orvo": {
         "url": "https://www.getorvo.com/api/mcp"
       }
     }
   }

4. Click Authenticate next to Orvo. Your browser opens; sign in to Orvo, choose Read only (recommended) or Read and make changes, and click Authorise & Connect.
5. When the dot next to Orvo turns green, ask the agent in the Agent Panel. Mentioning Orvo in your prompt helps it pick the right tools.

Option 2: use a personal token

1. In Orvo, open Settings → Integrations and find AI assistants (MCP). Choose an assistant that uses a token, such as Cursor (each account has one token), click Generate token and copy it; it’s shown once.
2. Add the token as a header in settings.json. With an Authorization header set, Zed skips the browser sign-in:
   settings.json Copy

   {
     "context_servers": {
       "orvo": {
         "url": "https://www.getorvo.com/api/mcp",
         "headers": {
           "Authorization": "Bearer YOUR_ORVO_TOKEN"
         }
       }
     }
   }

Read only, or read and make changes

With browser sign-in, you choose on Orvo’s page. To switch, use Log Out in Orvo’s menu under Settings → AI → MCP Servers and authenticate again.

Zed asks before running tools by default. Under agent.tool_permissions you can set rules per tool, for example keeping Orvo’s delete tools on confirm.

Either way, deleting never erases anything: People and notes go to Recently deleted for 30 days, daily limits cap how much an assistant can change, and changes to a person (their profile, tags, notes and linked actions) show in their activity as made via AI assistant. How Orvo keeps you in control.

Things to ask Zed