Envelope

MCP host setup

Envelope's hosted MCP server at https://mcp.openenvelope.org/api/mcp is the fastest way to run a multi-agent team — no infrastructure, no deployment scripts. Connect it to Claude.ai, ChatGPT, or Claude Code and your team runs directly from your AI tool.

Before you start

You need an Envelope account and at least one installed team. If you haven't designed a team yet, start at the workspace — describe your multi-agent workflow in plain language and Envelope structures it into a spec.

For Claude.ai and ChatGPT, authentication is handled via OAuth — you sign in through the connector flow. For Claude Code and direct API access, generate an API key from Account → API Keys.

Claude.ai

  1. Go to claude.ai and sign in
  2. Click Customize Claude (bottom-left)
  3. Select Connectors → Add connector
  4. Paste https://mcp.openenvelope.org/api/mcp and click Connect
  5. Complete the OAuth sign-in — you'll be redirected back to Claude with Envelope connected

Once connected, Claude can list your teams, trigger runs, browse the template library, and handle gate approvals — all from the conversation. No code required.

ChatGPT

  1. Go to chatgpt.com and sign in
  2. Start a new conversation and click the Tools icon
  3. Select Add tools → search for Envelope, or paste https://mcp.openenvelope.org/api/mcp
  4. Follow the OAuth sign-in flow

ChatGPT confirms the connection. You can now ask it to run your Envelope multi-agent teams directly.

Claude Code

Claude Code reads SKILL.md files automatically, so it knows how to use Envelope without manual setup. Add the server to your config:

{
  "mcpServers": {
    "envelope": {
      "command": "mcp-remote",
      "args": ["https://mcp.openenvelope.org/api/mcp"],
      "env": {
        "MCP_BEARER_TOKEN": "your_envelope_api_key"
      }
    }
  }
}

Replace your_envelope_api_key with a key from Account → API Keys. Restart Claude Code — Envelope tools appear in the tools list automatically.

→ See the Claude Code guide for more on designing and running teams from Claude Code.

Running a team after connecting

Once connected, use plain language:

  • "List my installed Envelope teams"
  • "Run my Support Triage team on this ticket: [paste content]"
  • "I have a gate waiting — the draft looks good, approve it"

The AI handles the MCP calls. You see the output and act on any human gates that pause the workflow.

Troubleshooting

Authentication error — your OAuth session may have expired. Disconnect and reconnect the Envelope connector in your AI tool settings.

Team not found — the team must be installed (not just designed) to run via MCP. Go to your workspace, find the team, and click Install.

→ Full MCP reference — all tools, authentication details, and rate limits

‹ All guidesDocs ›