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

# Claude (Web/Desktop)

> Add Firmable as a custom connector in Claude (Web) and Claude (Desktop)

Add the Firmable MCP server as a **custom connector** in Claude so it can query
Firmable data inside your conversations.

> [!NOTE]
>
> **Team and Enterprise plans:** an owner adds the connector under **Organization settings →
> Connectors → Add**, then hovers **Custom** and selects **Web**. Team members then connect to it
> from **Customize → Connectors** by clicking **Connect** on the connector labelled **Custom**.

> [!NOTE]
>
> You'll need the **MCP URL** and **Client ID** — see [**URL & Client ID**](https://docs.firmable.com/mcp/credentials.md).

## Claude (Web)

**1. Open Customize**

In [Claude](https://claude.ai), open the sidebar and click **Customize**.

![Claude (Web) sidebar with the Customize item highlighted](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-customize.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=69cecdb91c845f3b01a8532bdb3693b6)

**2. Add a custom connector**

Go to the **Connectors** tab, click the **+**, and choose **Add custom connector**.

![Connectors tab with the plus menu open showing Add custom connector](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-add-connector.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=f497740cf8ef5a7d042e07ec4d1bc157)

**3. Enter the Firmable MCP details**

* **Name:** anything you like — this guide uses `Firmable`
* **Remote MCP server URL:** the MCP URL
* Expand **Advanced settings** and enter your **OAuth Client ID** (your Firmable Client ID).

Find the MCP URL and Client ID on [**URL & Client ID**](https://docs.firmable.com/mcp/credentials.md). Then click **Add**.

![Add custom connector dialog with the Firmable name, MCP server URL, and OAuth Client ID filled in](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-form.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=009569c40289dcd9408de2f6c5c6f79a)

**4. Connect**

Firmable now appears under **Not connected**. Select it and click **Connect**.

![Firmable custom connector listed under Not connected with a Connect button](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-connect.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=6c5970724a8c8e01ddd7af11c8a254f1)

**5. Authorize**

Sign in to Firmable and click **Allow** to authorize the connection.

![Firmable OAuth screen requesting access, with an Allow button](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-authorize.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=8be4bb7d1325bc0f8b16363b7dff6932)

**6. Review tool permissions**

Once connected, choose when Claude is allowed to use each Firmable tool, then start using it in a chat.

![Connected Firmable connector showing the list of tools and their permission settings](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-connected.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=fe6700dba03c0185583f13984955b8a8)

## Claude (Desktop)

> [!NOTE]
>
> Custom connectors are brokered through your Claude account. If you **already added Firmable on the
> web**, it appears in Claude (Desktop) automatically — just open **Customize → Connectors** and click
> **Connect** (jump to step 4). If you haven't, add it from scratch below.

**1. Open Customize**

In Claude (Desktop), open the sidebar and click **Customize**.

![Claude (Desktop) sidebar with the Customize item highlighted](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-customize.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=d01319c85a213185b7a77d3ff0091d44)

**2. Add a custom connector**

Go to the **Connectors** tab, click the **+**, and choose **Add custom connector**.

![Claude (Desktop) Connectors tab with the plus menu open showing Add custom connector](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-add-connector.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=cac59608541d64ffea7960b2377db619)

**3. Enter the Firmable MCP details**

* **Name:** anything you like — this guide uses `Firmable`
* **Remote MCP server URL:** the MCP URL
* Expand **Advanced settings** and enter your **OAuth Client ID**.

Find the MCP URL and Client ID on [**URL & Client ID**](https://docs.firmable.com/mcp/credentials.md). Then click **Add**.

![Add custom connector dialog in Claude (Desktop) with the Firmable details filled in](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-form.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=dc7093cfff23beb8e09302ddabb6996b)

**4. Connect**

Firmable appears under **Not connected**. Select it and click **Connect**.

![Firmable custom connector listed under Not connected in Claude (Desktop) with a Connect button](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-connect.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=a2edb9f8cff728af6b2752aeb034a6ba)

**5. Authorize**

Claude opens your browser to authorize. Sign in to Firmable and click **Allow**.

![Firmable OAuth screen requesting access, with an Allow button](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-authorize.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=8be4bb7d1325bc0f8b16363b7dff6932)

**6. Review tool permissions**

Back in Claude (Desktop), Firmable shows as **Connected**. Choose when Claude is allowed to use each
tool, then start using it in a chat.

![Connected Firmable connector in Claude (Desktop) showing the list of tools and their permission settings](https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-connected.png?fit=max\&auto=format\&n=YWZrWVN9L2EJsC0i\&q=85\&s=8a8d34d13386ddd12cc4964a97ba4378)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.