Envelope

Connect Envelope to Claude.ai

Add Envelope as a connector in Claude.ai and your design workspace becomes available as a set of tools inside any conversation. Generate team specs, update designs, browse your template library, and manage your workspace — without leaving Claude.


What you get

Once connected, Claude has access to Envelope's design and workspace tools:

Workspace

| Tool | What it does | |---|---| | list_installs | Shows all teams in your workspace — name, status, and last run | | list_templates | Lists your template library — what's published and available to install |

Build

| Tool | What it does | |---|---| | generate_team | Generates a team definition from a natural-language description | | create_team | Saves a team definition as a private draft template | | update_team | Modifies an existing template using a natural-language instruction | | install_team | Installs a template into your workspace so it can be triggered | | uninstall_team | Removes an installed team | | publish_team | Publishes a draft template to the public marketplace |

Model routing

| Tool | What it does | |---|---| | get_agent_models | Lists each agent in an install with its current model assignment | | set_agent_model | Pins a specific model to an agent (overrides auto-routing) | | reset_agent_model | Clears a model override, returning the agent to automatic routing |


How to connect

Step 1 — Open your Claude settings

Go to claude.ai. Click the person icon in the top-right corner to open the menu, then go to Customize Claude.

Step 2 — Add a custom connector

Select Connectors from the left sidebar. Click Add connector. You'll see a field asking for a URL.

Step 3 — Paste the server URL

Enter:

https://mcp.openenvelope.org/api/mcp

Click Connect.

Step 4 — Sign in with Envelope

Claude will redirect you to an Envelope sign-in page. Enter your email — Envelope sends you a magic link. Click it, return to Claude.

Step 5 — Authorise the connection

You'll be shown a consent screen listing the tools Claude will be able to call. Approve access. You're connected.


Using it in a conversation

Once connected, Claude can call Envelope tools whenever it's relevant. You can also ask explicitly:

Generating an agent spec

"Generate an AI team that triages Zendesk tickets and drafts first responses"

Claude calls generate_team, builds the spec — roles, tools, reporting lines — and returns it ready to save or refine.

Updating a design

"Add a human approval gate before the outbound email agent sends anything"

Claude calls update_team with your instruction and returns the revised spec.

Browsing your library

"Show me my saved team templates"

Claude calls list_templates and lists everything in your workspace by name and status.


Troubleshooting

"I don't see a Connectors option"

Connectors are a Claude.ai feature available on Pro and higher plans. If you're on the free plan, this option won't appear.

"The connection timed out"

Try pasting the URL again and re-authenticating. If the issue persists, try in an incognito window to rule out session state.

"The tools don't appear when I try to use them"

Make sure the connector is toggled on in your Claude settings. In the Connectors panel, look for a toggle next to the Envelope connector — it should be enabled.

"I connected but Claude doesn't seem to know about my teams"

Ask Claude directly: "Use the list_installs tool to show me my Envelope teams." This forces a tool call if Claude isn't automatically using them.


Disconnect

To remove the connection, go to Customize Claude → Connectors, find Envelope, and click Remove. This revokes Claude's access token — your Envelope data is unaffected.