> ## 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>

<Note>
  You'll need the **MCP URL** and **Client ID** — see [**URL & Client ID**](/mcp/credentials).
</Note>

## Claude (Web)

<Steps>
  <Step title="Open Customize">
    In [Claude](https://claude.ai), open the sidebar and click **Customize**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-customize.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=69cecdb91c845f3b01a8532bdb3693b6" alt="Claude (Web) sidebar with the Customize item highlighted" width="572" height="695" data-path="images/mcp/claude-customize.png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    Go to the **Connectors** tab, click the **+**, and choose **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-add-connector.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=f497740cf8ef5a7d042e07ec4d1bc157" alt="Connectors tab with the plus menu open showing Add custom connector" width="1200" height="418" data-path="images/mcp/claude-add-connector.png" />
    </Frame>
  </Step>

  <Step title="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**](/mcp/credentials). Then click **Add**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-form.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=009569c40289dcd9408de2f6c5c6f79a" alt="Add custom connector dialog with the Firmable name, MCP server URL, and OAuth Client ID filled in" width="1194" height="1454" data-path="images/mcp/claude-form.png" />
    </Frame>
  </Step>

  <Step title="Connect">
    Firmable now appears under **Not connected**. Select it and click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-connect.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=6c5970724a8c8e01ddd7af11c8a254f1" alt="Firmable custom connector listed under Not connected with a Connect button" width="1200" height="532" data-path="images/mcp/claude-connect.png" />
    </Frame>
  </Step>

  <Step title="Authorize">
    Sign in to Firmable and click **Allow** to authorize the connection.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-authorize.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=8be4bb7d1325bc0f8b16363b7dff6932" alt="Firmable OAuth screen requesting access, with an Allow button" width="1200" height="606" data-path="images/mcp/claude-authorize.png" />
    </Frame>
  </Step>

  <Step title="Review tool permissions">
    Once connected, choose when Claude is allowed to use each Firmable tool, then start using it in a chat.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-connected.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=fe6700dba03c0185583f13984955b8a8" alt="Connected Firmable connector showing the list of tools and their permission settings" width="1200" height="538" data-path="images/mcp/claude-connected.png" />
    </Frame>
  </Step>
</Steps>

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

<Steps>
  <Step title="Open Customize">
    In Claude (Desktop), open the sidebar and click **Customize**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-customize.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=d01319c85a213185b7a77d3ff0091d44" alt="Claude (Desktop) sidebar with the Customize item highlighted" width="780" height="930" data-path="images/mcp/claude-desktop-customize.png" />
    </Frame>
  </Step>

  <Step title="Add a custom connector">
    Go to the **Connectors** tab, click the **+**, and choose **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-add-connector.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=cac59608541d64ffea7960b2377db619" alt="Claude (Desktop) Connectors tab with the plus menu open showing Add custom connector" width="1200" height="569" data-path="images/mcp/claude-desktop-add-connector.png" />
    </Frame>
  </Step>

  <Step title="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**](/mcp/credentials). Then click **Add**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-form.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=dc7093cfff23beb8e09302ddabb6996b" alt="Add custom connector dialog in Claude (Desktop) with the Firmable details filled in" width="1200" height="1108" data-path="images/mcp/claude-desktop-form.png" />
    </Frame>
  </Step>

  <Step title="Connect">
    Firmable appears under **Not connected**. Select it and click **Connect**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-connect.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=a2edb9f8cff728af6b2752aeb034a6ba" alt="Firmable custom connector listed under Not connected in Claude (Desktop) with a Connect button" width="1200" height="797" data-path="images/mcp/claude-desktop-connect.png" />
    </Frame>
  </Step>

  <Step title="Authorize">
    Claude opens your browser to authorize. Sign in to Firmable and click **Allow**.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-authorize.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=8be4bb7d1325bc0f8b16363b7dff6932" alt="Firmable OAuth screen requesting access, with an Allow button" width="1200" height="606" data-path="images/mcp/claude-authorize.png" />
    </Frame>
  </Step>

  <Step title="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.

    <Frame>
      <img src="https://mintcdn.com/firmable/YWZrWVN9L2EJsC0i/images/mcp/claude-desktop-connected.png?fit=max&auto=format&n=YWZrWVN9L2EJsC0i&q=85&s=8a8d34d13386ddd12cc4964a97ba4378" alt="Connected Firmable connector in Claude (Desktop) showing the list of tools and their permission settings" width="1200" height="789" data-path="images/mcp/claude-desktop-connected.png" />
    </Frame>
  </Step>
</Steps>