Connect Claude Code

Install the plugin

The plugin is the fastest method. In one step, it connects the server and installs the Orcha usage guides as skills. You do not need a token.

/plugin marketplace add westonhancock/orcha-mcp
/plugin install orcha@orcha

At first use, Claude Code starts the OAuth procedure. In this procedure:

1. Select the workspace.
2. Select the permissions for the connection: read, write, and delete.

The plugin adds these skills: /orcha:retrieval, /orcha:citations, /orcha:authoring, and /orcha:troubleshooting. Claude loads the skill that a task needs.

The remainder of this page shows how to connect the server manually. Use the manual method if you need a bearer token or a pinned project configuration. Also use it if you do not want the plugin.

Prerequisites

You must have an API token from the API Tokens page. The token must have the permissions that you want to give Claude Code. For retrieval, read is sufficient. If the agent must create or update context, add write. Refer to Tokens and scoping.

Add the server

claude mcp add --transport http orcha https://app.tryorcha.com/mcp \
  --header "Authorization: Bearer orca_your_token_here"

To share the configuration with your team through .mcp.json, add --scope project. To use the configuration in all your projects, add --scope user.

Do not put the token in a project-scoped configuration that you commit. Other persons can read the token in the repository. Put the token in an environment variable:

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

Verify

1. In Claude Code, run /mcp.
2. Make sure that the orcha server is connected.
3. Make sure that the list shows its tools.

Usage

Orcha tells Claude Code to start with get_workspace_overview when it does not know a workspace. Claude Code then uses search_context for questions. It uses memories for curated workflows. Try these prompts:

• "Search my Orcha workspace for our deployment requirements"
• "Check which Orcha memories apply to this task and use the best match"
• "Create a file in Orcha summarizing the decisions we just made"