> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use with coding agent

The official Ampersand docs MCP server provides access to the full Ampersand documentation context, directly within your favorite Coding Agent or IDE. You can use it to help you build integrations quickly with Ampersand.

Ampersand's docs MCP server is hosted at `https://docs.withampersand.com/mcp`.

If you are using Claude Code, you can run this command:

```shell theme={null}
claude mcp add ampersand-docs --transport http "https://docs.withampersand.com/mcp"
```

## Client specific configuration

You can use Ampersand's MCP server with any AI application that support [MCP](https://modelcontextprotocol.io/clients). You need to add `https://docs.withampersand.com/mcp` to the appropriate configuration file or setting. Below are some of the most popular coding agents, and where to configure MCP servers for them:

| Client                 | Configuration File Location                                                                                               | Documentation                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
| Claude Code            | `.mcp.json` (project scope) or `~/.claude.json` (user/local scope); or `claude mcp add`                                   | [link](https://code.claude.com/docs/en/mcp)                                  |
| Cursor                 | `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project)                                                             | [link](https://cursor.com/docs/mcp)                                          |
| JetBrains IDEs (Junie) | `~/.junie/mcp/mcp.json` (user) or `.junie/mcp/mcp.json` (project); or **Settings → Tools → Junie → MCP Settings**         | [link](https://junie.jetbrains.com/docs/junie-plugin-mcp-settings.html)      |
| Visual Studio Code     | `.vscode/mcp.json` (workspace) or user `mcp.json` (**MCP: Open User Configuration**)                                      | [link](https://code.visualstudio.com/docs/copilot/customization/mcp-servers) |
| Windsurf               | `~/.codeium/windsurf/mcp_config.json`                                                                                     | [link](https://docs.windsurf.com/windsurf/cascade/mcp)                       |
| Zed                    | `context_servers` in `settings.json` (macOS/Linux: `~/.config/zed/settings.json`; Windows: `%AppData%\Zed\settings.json`) | [link](https://zed.dev/docs/ai/mcp)                                          |

## Tips for better prompts

* Mention Ampersand in your prompt. For example, "How do I build X with Ampersand?"

* 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."

* Ask your agent to refer to Ampersand's OpenAPI spec at [https://github.com/amp-labs/openapi](https://github.com/amp-labs/openapi).
