> For the complete documentation index, see [llms.txt](https://docs.fastn.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fastn.ai/build/building-from-your-ai-agent/mcp-gateway/claude.md).

# Claude

Add fastn to Claude as a custom connector, then build integrations from a Claude chat.

Add fastn to Claude once, sign in, then ask for the integration in a chat. This works in claude.ai in the browser and in the Claude desktop app, which share the same connectors.

{% hint style="info" %}
**Before you start:** on a Claude Team or Enterprise plan, only an organization owner can add a custom connector. Members connect their own account once the owner has added fastn. See [Team and Enterprise plans](#team-and-enterprise-plans).
{% endhint %}

## Add fastn

{% stepper %}
{% step %}

#### Open Add to Claude from fastn

In fastn, click **Connect AI tools** in the top bar (or open **Embed → API keys and MCP** → **MCP server**) and click **Add to Claude**. You need the **Developer** role or above. Claude opens the **Add custom connector** form with the name and URL already filled in.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-102e5a1125e77cdd629c81f88cd57886036151ca%2Fmcp-claude-add-custom-connector.webp?alt=media" alt="Claude&#x27;s Add custom connector form opened from a link, with the warning This connector was suggested by an external link, the name Fastn, the URL https://mcp.fastn.dev/fastn-workspace, Connects to mcp.fastn.dev, and Cancel and Continue buttons"><figcaption><p>Claude warns that the connector came from a link. Check the URL is <code>https://mcp.fastn.dev/fastn-workspace</code>, then click <strong>Continue</strong>.</p></figcaption></figure>

To add it by hand instead: in Claude, open **Customize** → **Connectors**, click **Add** → **Add custom connector**, and enter the name `Fastn` and the URL `https://mcp.fastn.dev/fastn-workspace`.
{% endstep %}

{% step %}

#### Keep the detected sign-in settings

Claude checks the server and preselects how to sign in. Leave **Sign in now** and **Use Claude's published identity** selected (both marked **Detected**), and click **Add**. You do not need request headers or your own OAuth client.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-c61a9a53e465205ebfa70c7e569cad012759500f%2Fmcp-claude-auth-options.webp?alt=media" alt="Claude&#x27;s Add custom connector form after Continue: Authentication with Sign in now selected and marked Detected, Sign in when needed and No sign-in; OAuth client with Use Claude&#x27;s published identity selected and marked Detected, Register automatically and Use your own OAuth client; and a Request headers section"><figcaption><p>Both defaults are right for fastn.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Connect

Claude opens the new connector and shows *You're not connected to fastn yet*. Click **Connect**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-183b7b271c9c600af7757abaf695b2ad1f410348%2Fmcp-claude-not-connected.webp?alt=media" alt="Claude&#x27;s Fastn connector page showing the fastn logo, the URL https://mcp.fastn.dev/fastn-workspace, the text You&#x27;re not connected to Fastn yet, and a Connect button"><figcaption><p>The connector is added but not signed in yet.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Pick the workspace

fastn opens in a new tab. Sign in if you are not already. If you belong to more than one fastn org, pick the workspace Claude works in (with one org, fastn skips this screen). **The org selected in fastn** follows whichever org you have open in the fastn dashboard; picking a named org pins Claude to it. Click **Connect**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-f25056c47ea9c5eed4303a30931117911ae7905f%2Fmcp-claude-choose-workspace.webp?alt=media" alt="fastn&#x27;s page titled Which workspace should Claude (claude.ai) use?, with The org selected in fastn chosen and described as Now Docs-test, moves when you switch org in the fastn dashboard, a list of other orgs, and a Connect button"><figcaption><p>The list shows every org you belong to. You can change the choice later on the Tools page in Connect.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Check the tools

Back in Claude, a *Connected to fastn* notice appears and the connector lists fastn's tools under **Tool permissions**. Choose for each group whether Claude may use the tools without asking, needs your approval, or may not use them.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-6536c93471328f6abbab7e534a477b8769a44dd1%2Fmcp-claude-connected-tools.webp?alt=media" alt="Claude&#x27;s Fastn connector page after connecting, with a Disconnect button, the URL, and Tool permissions listing 75 read-only tools such as fastnPlatform__getAction and fastnPlatform__getConnector, each with allow, needs approval and block icons, and a Needs approval setting for the group"><figcaption><p>Every fastn tool starts on <strong>Needs approval</strong>.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Use it in a chat

1. In a new chat, click **+** → **Connectors** and make sure **fastn** is switched on.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-96bf2c5838f7247db818ab6539eac5f2eeb40c12%2Fmcp-claude-chat-connectors.png?alt=media" alt="Claude&#x27;s chat + menu open on Connectors, with Fastn switched on"><figcaption><p>Switch fastn on for the chat.</p></figcaption></figure>

2. Ask for the outcome in one sentence. To check the connection first, ask *What can fastn do for me?* or *List my workflows*.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-cc3d334a3ccbb16254cc8e110eb3de28b601d95c%2Fmcp-claude-prompt.png?alt=media" alt="A Claude message reading: Using fastn, save invoice emails from Gmail to a Google Sheet. Test it, then add it to my widget."><figcaption><p>Name the systems, what starts it and what moves.</p></figcaption></figure>

[Writing a good first message](https://docs.fastn.ai/build/agent.md#writing-a-good-first-message) has more examples.

3. Each time Claude wants to use a fastn tool, it asks first: **Decline**, **Always allow** or **Allow once**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-c2d4d058c22fcc36413d4ab3e6c02a652ecc321f%2Fmcp-claude-tool-approval.webp?alt=media" alt="Claude asking Claude wants to use fastnPlatform__listWorkflows from Fastn, with the argument Sort status, and Decline, Always allow and Allow once buttons"><figcaption><p>The prompt names the tool and the connector it comes from.</p></figcaption></figure>

4. Claude then asks only the business questions it can't answer itself, with its recommended answer already selected.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-2b3e8e1d2132b65793a3fa472450feadf80f0265%2Fmcp-claude-question-invoice.png?alt=media" alt="Claude asking What counts as an invoice email?, with Subject or body mentions invoice marked recommended"><figcaption><p>A business question, with the recommended answer first.</p></figcaption></figure>

From here Claude works through the same steps as every agent: see [Building from your AI agent](https://docs.fastn.ai/build/building-from-your-ai-agent.md).

## Team and Enterprise plans

Only an organization owner can add a custom connector. Members see the note below in place of **Add custom connector**, and connect their own account once the owner has added fastn.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-6db70b80e68e376bf3d3ce8383b78d5e40c95f24%2Fmcp-claude-team-owner-only.png?alt=media" alt="Claude&#x27;s Add custom connector option grayed out, with the note Ask an organization owner to add this for your team"><figcaption><p>What a Team or Enterprise member sees.</p></figcaption></figure>

Owners can use **Add for the whole organization** on the second **Claude** tile, under **Other**, on fastn's MCP page instead of **Add to Claude**.

If you belong to more than one Claude workspace (for example Personal and a Team), add fastn in the one you chat in. A connector only shows in the workspace it was added to.

## Troubleshooting

* *A connector with this URL already exists in your organization.* Someone in your Claude organization already added fastn. Open **Customize** → **Connectors** and connect that one instead of adding another.
* **fastn works on the wrong org.** Open the connector, click **Disconnect**, then **Connect** again and pick the workspace (the picker appears when you belong to more than one fastn org). If you chose **The org selected in fastn**, switch org in the fastn dashboard instead.
* **Claude Code or the Claude desktop config file.** These are set up separately: see [Claude Code](https://docs.fastn.ai/build/building-from-your-ai-agent/mcp-gateway/claude-code.md).

{% hint style="info" %}
This page is for your own team. Your customers reach their integrations from Claude a different way: see [Connect Claude and other AI clients](https://docs.fastn.ai/for-your-customers/end-user/connecting-claude.md).
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.fastn.ai/build/building-from-your-ai-agent/mcp-gateway/claude.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
