Connect Cursor

Prerequisites

• You must have an Orcha account. Refer to the Quickstart.
• You must have a Cursor version that supports remote MCP servers over Streamable HTTP.

You do not need an API token. Cursor connects over OAuth.

Add the server

Cursor connects to https://app.tryorcha.com/mcp as a remote MCP server. These steps follow the Cursor documentation, Model Context Protocol (MCP).

1. Open the MCP configuration file. Use one of these files:
   • ~/.cursor/mcp.json gives the server to all of your projects.
   • .cursor/mcp.json in the project folder gives the server to one project.
2. Add the Orcha server with only its URL. Do not add a header.

{
  "mcpServers": {
    "orcha": {
      "url": "https://app.tryorcha.com/mcp"
    }
  }
}

3. Save the file.
4. Open Cursor Settings > Tools & MCP. The orcha server shows that it needs a sign-in.
5. Click the sign-in control for orcha. Cursor opens the Orcha sign-in page in your browser.
6. Sign in to Orcha.

Orcha registers the Cursor client through dynamic client registration. Thus, you do not copy a client ID or a secret. Do not add an auth object to the entry.

On the consent screen:

1. Select the workspace.
2. Select the permissions for the connection: read, write, and delete. For questions and citations, read is sufficient.
3. Approve the connection.

When the server connects, Tools & MCP shows the Orcha tools. To test the connection, ask "What is in my Orcha workspace?" Cursor must call get_workspace_overview and describe your content.

Do not add a slash at the end of the URL. Use /mcp, not /mcp/.

Connect with an API token

Use this method only if you cannot use OAuth. For example, you must use a pinned project configuration that runs without a sign-in, your Cursor version does not support OAuth for remote servers, or you must use a token with a fixed folder scope.

1. Open the API Tokens page in Orcha. It is in the account menu at the bottom left of the sidebar.
2. Create a token with the permissions that you want to give Cursor. For retrieval, read is sufficient. Refer to Tokens and scoping.
3. Copy the token into an environment variable, for example ORCHA_TOKEN. Orcha shows the token only one time.
4. Add the token to the server entry as a header:

{
  "mcpServers": {
    "orcha": {
      "url": "https://app.tryorcha.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:ORCHA_TOKEN}"
      }
    }
  }
}

If you commit .cursor/mcp.json, do not put the token in the file. Other persons can read the token in the repository. Use an environment variable that each team member sets locally, as in the example above.

Usage

• "Search my Orcha workspace for the API design decisions"
• "Check my api-spec.json in Orcha and generate TypeScript types"
• "Update my config.json in Orcha with the new settings"