> 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/devin.md).

# Devin

Add fastn to Devin Desktop (formerly Windsurf) as a custom MCP server, sign in, and use your fastn tools from Devin.

Devin Desktop, formerly Windsurf, adds fastn from **Customize** as a custom MCP server. Sign in once, then ask for the integration in a Devin session.

{% hint style="info" %}
**Before you start:** sign in to Devin Desktop. Running a session uses Devin credits, so you need credits or a paid plan to use fastn's tools.
{% endhint %}

## Add fastn

{% stepper %}
{% step %}

#### Open New MCP

In Devin Desktop, click **Customize** in the sidebar and open the **MCPs** tab. Click **+** and choose **New MCP**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-354fee281fe90adb4235a58b75a87cc2e2d672c9%2Fmcp-devin-add-menu.webp?alt=media" alt="Devin Desktop&#x27;s Customize page on the MCPs tab, titled Install MCPs for Myself, with the plus menu open showing New MCP, From plugin marketplace (Recommended) and From MCP marketplace (Legacy)"><figcaption><p>Leave <strong>Install MCPs for</strong> on <strong>Myself</strong>.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Enter fastn's URL

Enter **Server name** `fastn` and a short description. Under **Connection**, set **Transport type** to **HTTP**, **Server URL** to `https://mcp.fastn.dev/fastn-workspace` and **Authentication** to **OAuth**, then click **Add**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-f91b6e63b5a61fb1fa9001f1562113873bcf160b%2Fmcp-devin-add-server.webp?alt=media" alt="Devin Desktop&#x27;s New MCP form with Server name fastn, a short description, Transport type HTTP, Server URL https://mcp.fastn.dev/fastn-workspace, Authentication OAuth, an empty Custom headers section, and Cancel and Add buttons"><figcaption><p>fastn signs you in with OAuth, so no header is needed.</p></figcaption></figure>

Devin shows **Enable MCP integration**. Tick **I understand and want to proceed** and click **Add**. fastn appears in the list with *Needs connection*.
{% endstep %}

{% step %}

#### Connect and pick the workspace

Click **Connect MCP** on fastn's row, then **Open** when Devin asks to open the external website. fastn opens in your browser. Sign in if asked. If you belong to more than one fastn org, pick the workspace Devin works in and click **Connect**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-3df04ec48813ee21b5dac172ca56ae941ae0b2ca%2Fmcp-devin-choose-workspace.webp?alt=media" alt="fastn&#x27;s page titled Which workspace should Devin use?, with The org selected in fastn chosen, a list of orgs and a Connect button"><figcaption><p><strong>The org selected in fastn</strong> follows whichever org you have open in the fastn dashboard; picking a named org pins Devin to it.</p></figcaption></figure>

The browser returns to Devin Desktop, which shows *MCP account linked successfully* and fastn as **Connected**.

<figure><img src="https://1255842839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3iSr2Tx8FvvuoLPncziH%2Fuploads%2Fgit-blob-d13bf87a0d71e6ac7cb4d275f1c4f0e8a9090d44%2Fmcp-devin-connected.webp?alt=media" alt="Devin Desktop&#x27;s MCPs tab listing fastn under From plugins as Connected with the URL https://mcp.fastn.dev/fastn-workspace and its toggle switched on"><figcaption><p>The toggle turns fastn off without removing it.</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Use it

Start a **New session** and ask for the outcome in one sentence. To check the connection first, ask *Who am I in fastn?*

From here Devin 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).

## Devin CLI

The `devin` CLI adds fastn with one command and signs in from the terminal:

```
devin mcp add -s user fastn https://mcp.fastn.dev/fastn-workspace
devin mcp login fastn
```

## Troubleshooting

* **fastn stays on Needs connection.** Click **Connect MCP** again and finish the sign-in in the browser. If the row doesn't change, switch to another tab under **Customize** and back.
* **You ran out of free credits.** Devin needs credits to run a session, including one that only calls fastn. This message comes from Devin, not fastn.
* **Devin works on the wrong org.** Remove fastn under **Customize** → **MCPs**, add it again and pick the workspace when you sign in.


---

# 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/devin.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.
