> ## Documentation Index
> Fetch the complete documentation index at: https://architect-d889a35e-sync-pr-3380.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect MCP with Cursor

> Set up Architect's MCP server in Cursor to read docs and call the Customer API from your editor

## Prerequisites

* [Cursor](https://cursor.com) installed
* An Architect account with access to a workspace

## Setup

<Steps>
  <Step title="Open Cursor MCP settings">
    Open Cursor and go to **Settings** → **MCP**.

    You can also press `Cmd+Shift+P` (Mac) or `Ctrl+Shift+P` (Windows/Linux) and search for **"MCP: Settings"**.
  </Step>

  <Step title="Add the Architect MCP server">
    Click **"Add new MCP server"** and enter:

    * **Name:** `Architect`
    * **Type:** `sse`
    * **URL:** `https://mcp.tryarchitect.com/mcp`

    Alternatively, add it manually to your `.cursor/mcp.json` file:

    ```json theme={null}
    {
      "mcpServers": {
        "architect": {
          "url": "https://mcp.tryarchitect.com/mcp"
        }
      }
    }
    ```
  </Step>

  <Step title="Authenticate with Architect">
    When you first use an Architect tool in Cursor's Agent mode, a browser window will open asking you to sign in to your Architect account. Grant the requested permissions and your session will be saved.
  </Step>

  <Step title="Start using Architect tools">
    In Cursor's **Agent mode** (not regular chat), you can now ask it to interact with your Architect workspace:

    * *"Use architect\_docs to show me the available API endpoints"*
    * *"List my pages using the Architect API"*
    * *"Look up how to create a prospect, then create one for [jane@acme.com](mailto:jane@acme.com)"*

    <Note>
      MCP tools are only available in **Agent mode** (Cmd+I / Ctrl+I), not in regular chat.
    </Note>
  </Step>
</Steps>

## Available tools

Once connected, Cursor has access to two Architect MCP tools:

| Tool             | Description                                                                                                  |
| ---------------- | ------------------------------------------------------------------------------------------------------------ |
| `architect_docs` | Read Architect MCP docs plus targeted Customer API reference slices before you make a request.               |
| `architect_api`  | Call Customer API endpoints for the authenticated tenant after you know the exact method, path, and payload. |

The recommended workflow is: use `architect_docs` first to understand what's available, then use `architect_api` to execute.

## Troubleshooting

<AccordionGroup>
  <Accordion title="Tools don't appear in Cursor">
    MCP tools only work in **Agent mode**. Make sure you're using `Cmd+I` / `Ctrl+I`, not regular chat. Also verify the MCP server shows a green status indicator in **Settings → MCP**.
  </Accordion>

  <Accordion title="Server shows as disconnected">
    Check that the URL is exactly `https://mcp.tryarchitect.com/mcp`. Try removing the server and re-adding it. If it still fails, restart Cursor.
  </Accordion>

  <Accordion title="Authentication window doesn't appear">
    Make sure your browser isn't blocking pop-ups from Cursor. Try opening `https://mcp.tryarchitect.com/mcp` directly in your browser to verify the server is reachable.
  </Accordion>
</AccordionGroup>