- The builder MCP server helps you build and manage integrations with Ampersand. Your agent can use it to create new integrations, manage installations, connections and destinations, troubleshoot failed operations, and scaffold webhook handlers. It requires an Ampersand account.
- The docs MCP server gives your agent access to the Ampersand documentation. It does not require an Ampersand account.
Set up the MCP servers
The builder MCP server is athttps://builder-mcp.ampersand.ai/v1/mcp, and the docs MCP server is at https://docs.ampersand.ai/mcp. Pick your coding agent:
- Claude Code
- Cursor
- VS Code
- Codex
- JetBrains
- Windsurf
- Zed
- Other
Run these commands in your terminal:Then launch Claude Code, type
/mcp, select ampersand, choose Authenticate, and sign in to your Ampersand account.Tips for better prompts
- Mention Ampersand in your prompt. For example, “How do I build X with Ampersand?”
- Name the project you want your agent to work in. For example, “In my Ampersand project acme-dev, why did the last read of Salesforce contacts fail?”
- Ask your agent to verify field names against the provider’s documentation. For example, “Verify that the field names are real field names for the Account object, according to Salesforce documentation.”
- Explicitly ask your agent to refer to Ampersand documentation and OpenAPI spec.
-
For example
amp.yamlfiles, point your agent to the starter project or the samples repo. - If a deploy fails with “project doesn’t exist”, give your agent your project ID from the dashboard instead of the project name.

