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

# Claude OAuth Setup

> Connect Surface to Claude via OAuth using the Connectors feature — no API key required

Claude supports connecting to MCP servers via OAuth through its **Connectors** feature. This lets you connect Surface to Claude without needing to manage API keys — just authenticate with your Surface account directly.

## Setup

<Steps>
  <Step title="Open the Connectors page">
    Go to [claude.ai/customize/connectors](https://claude.ai/customize/connectors). Click the **+** button at the top and choose **Add custom connector**.

    <Frame>
      <img src="https://mintcdn.com/surfacelabs/XbrZsaqMxVER3kJw/images/mcp-server/claude-oauth/connectors-page.png?fit=max&auto=format&n=XbrZsaqMxVER3kJw&q=85&s=2e9a65ab131cb28fbbcd251cb7003ff4" alt="Claude Connectors page showing the Add custom connector option" width="2580" height="1380" data-path="images/mcp-server/claude-oauth/connectors-page.png" />
    </Frame>
  </Step>

  <Step title="Configure the connector">
    In the modal that appears, fill in the following:

    * **Name:** `Surface`
    * **Remote MCP server URL:** `https://app.withsurface.com/mcp`

    Then click **Add**.

    <Frame>
      <img src="https://mintcdn.com/surfacelabs/XbrZsaqMxVER3kJw/images/mcp-server/claude-oauth/add-custom-connector.png?fit=max&auto=format&n=XbrZsaqMxVER3kJw&q=85&s=d41e7f0d7a1bab25c1a2a4f169bf5a80" alt="Add custom connector modal with Surface name and MCP URL filled in" width="2762" height="1470" data-path="images/mcp-server/claude-oauth/add-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="Connect your account">
    After adding the connector, click the **Connect** button to authenticate with your Surface account via OAuth.

    <Frame>
      <img src="https://mintcdn.com/surfacelabs/XbrZsaqMxVER3kJw/images/mcp-server/claude-oauth/click-connect.png?fit=max&auto=format&n=XbrZsaqMxVER3kJw&q=85&s=e684d971c71801f67fe06ebf0ed53597" alt="Surface connector page with Connect button" width="2748" height="1450" data-path="images/mcp-server/claude-oauth/click-connect.png" />
    </Frame>

    Choose your environment and complete the connection. That's it — Surface is now available as a connector in Claude.
  </Step>

  <Step title="Start using Surface in Claude">
    You can now toggle the Surface connector on in any Claude chat via the **+** menu and **Connectors**. Once enabled, Claude can use all Surface MCP tools to query your forms, responses, leads, and more.

    <Frame>
      <img src="https://mintcdn.com/surfacelabs/XbrZsaqMxVER3kJw/images/mcp-server/claude-oauth/use-in-chat.png?fit=max&auto=format&n=XbrZsaqMxVER3kJw&q=85&s=7d415ea131810a79ba309cf9e09d0a2a" alt="Claude chat showing Surface connector enabled alongside other connectors" width="2758" height="1466" data-path="images/mcp-server/claude-oauth/use-in-chat.png" />
    </Frame>
  </Step>
</Steps>

<Info>
  The OAuth connection is tied to your Surface account and environment. You don't need to manage or rotate API keys — Claude handles the authentication automatically.
</Info>
