> For the complete documentation index, see [llms.txt](https://typo.gitbook.io/typo-help-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://typo.gitbook.io/typo-help-docs/platform/settings-and-admin/metric-configurations/typo-mcp-server.md).

# Typo MCP Server

Connect Typo MCP Server with your AI coding assistants like Clade, OpenAI, and Cursor to\
retrieve engineering insights and build reports directly within your existing tools.

To setup MCP server, follow these steps - 

1. Navigate to Settings > [MCP Server](https://app.typoapp.io/settings/mcp-server)

<div align="left"><figure><img src="/files/lxpAB1YRYAAOeaU3YsGF" alt="" width="563"><figcaption></figcaption></figure></div>

2. Choose the AI assistant you want to connect the Typo MCP Server with, and click on Generate token

<div align="left"><figure><img src="/files/TbwqkzYkkEwAxlm22VMj" alt="" width="563"><figcaption></figcaption></figure></div>

3. Copy the access token &  copy your Access token in a safe place; you won't be able to view it again. Keep it secure, as anyone with your API token can make requests on your behalf. If you lose it, you'll need to generate a new one.

* **Follow these next steps for Claude -**
  * In Claude, go to Customise -> Connectors.
  * Click the "+" icon next to Connectors and click on "Add Custom Connector".
  * Enter a name (e.g., Typo-MCP-Server) and the MCP server URL:\
    `https://typo-mcp-server-735702776136.us-central1.run.app/mcp`
  * Skip "Advanced settings" — Typo doesn't need an OAuth Client ID/Secret, and click "Add".
  * The Typo connector now appears in your Connectors list. Click "Connect" to authenticate.
  * Claude redirects to your Typo login page. Paste the Claude Token, then click "Authorise." (An invalid token gives "Failed to establish connection.")
  * Open a new chat, click the "+" at the lower left, choose "Connectors," and toggle Typo-MCP-Server on for that conversation.
* **Follow these next steps for Cursor -**
  * In Cursor, go to Settings -> Tools & MCPs. Under Installed MCP Servers, click "Add Custom MCP".
  * When the mcp.json file opens, add the following configuration, replacing \<NAME> with a name of your choice (e.g., Typo-MCP-Server):

    ```
    {
      "mcpServers": {
        "<NAME>": {
          "url": "https://typo-mcp-server-735702776136.us-central1.run.app/mcp"
        }
      }
    }
    ```

    ![copy](https://app.typoapp.io/images/copy.svg)
  * Save and close the mcp.json file. The Typo MCP server now appears under Installed MCP Servers. Click "Connect" to begin authentication.
  * You'll be redirected to the Typo login page. Paste your Cursor Token, click "Authorise", and then select "Open Cursor" when prompted. (Invalid token gives "Failed to establish connection.")
  * Open a new chat, switch to "Ask" mode, and start asking queries.
* **Follow these next steps for OpenAI -**
  * In ChatGPT, go to Settings -> Apps -> Advanced Settings, enable "Developer Mode", and click "Create App".
  * Enter a name (e.g., Typo-MCP-Server) and the MCP server URL:

    ```
    https://typo-mcp-server-735702776136.us-central1.run.app/mcp
    ```

    ![copy](https://app.typoapp.io/images/copy.svg)
  * Set Authentication to "OAuth". Under Advanced OAuth Settings, select "Dynamic Client Registration (DCR)", choose "I understand and want to continue," and click "Create".
  * Select "Sign in with Typo-MCP-Server". You'll be redirected to the Typo login page. Paste your ChatGPT Token and click "Authorise." (An invalid token gives "Failed to establish connection.")
  * Open a new chat, click the "+" button, choose "More", select "Typo-MCP-Server" for the conversation, and start asking queries.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://typo.gitbook.io/typo-help-docs/platform/settings-and-admin/metric-configurations/typo-mcp-server.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.