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

# [Beta] Airbridge MCP

Access Airbridge data from AI services like Claude, Claude Code, ChatGPT, and Codex through MCP.

<Info>
  **Note**

  This feature is currently available in beta. Some specifications may change as we stabilize the service.
</Info>

## Airbridge MCP

MCP (Model Context Protocol) lets AI services connect to external data sources. With Airbridge MCP, you can access your Airbridge data directly from Claude, Claude Code, ChatGPT, Codex, and more. Ask questions, get reports, and explore your data just by typing requests.

## Set up Airbridge MCP

To access Airbridge data through MCP, you need to activate the MCP token. On the access permission page, review the **MCP Token Activation Notice**. You can activate the MCP token by checking the **I understand** checkbox and clicking **Allow**.

<Frame>
  <img src="https://mintcdn.com/airbridge-help-center/xwYukWBgLcUpDiQI/asset/image/mcp-access-permission-dialog.png?fit=max&auto=format&n=xwYukWBgLcUpDiQI&q=85&s=5b21673507f75a5019400e9bc63083a4" alt="mcp" width="1400" height="800" data-path="asset/image/mcp-access-permission-dialog.png" />
</Frame>

<Accordion title="MCP token activation notice">
  Enabling this token **allows compatible AI clients to access certain Airbridge data and functionalities** through the Model Context Protocol (MCP).

  Airbridge MCP operates according to the following principles:

  * **No Storage** – Data is processed in real time and is not stored by MCP servers.
  * **No Training** – Customer data is not used to train AI models.
  * **No Sharing** – Data is not shared with third parties other than the authorized MCP client.
  * **Encryption** – Data is encrypted during transmission.

  **The MCP feature may enable integrations with external AI clients or tools that are not operated by Airbridge.** Once data is transmitted to such services through MCP, the processing, storage, or use of that data is subject to the policies and responsibilities of the respective external service.

  Customers are responsible for managing and protecting MCP tokens and must control which clients, tools, or agents are permitted to use them. If unauthorized use is suspected, you should immediately disable the token.

  By activating an MCP token, you acknowledge that you understand and agree to the above conditions.
</Accordion>

Select your AI service to view setup instructions.

<AccordionGroup>
  <Accordion title="Claude web or desktop app">
    MCP is available on Pro, Max, Team, and Enterprise plans. For Team and Enterprise plans, the Owner must first add the connector to the organization.

    1. Go to [claude.ai](https://claude.ai/) or open the Claude desktop app.
    2. Click your profile icon in the bottom-left corner.
    3. Go to **\[Settings]>\[Connectors]** and click **Add custom connector**.
    4. Enter the following Airbridge MCP details:
       1. **Name:** Airbridge
       2. **Remote MCP server URL:** [https://mcp.airbridge.io/mcp](https://mcp.airbridge.io/mcp)
    5. Click **Add**.
    6. Back on the **\[Connectors]** page, find **Airbridge**, and click **Connect**.
    7. Sign in to Airbridge on the sign-in page that appears.
    8. Review the tools you’re granting access to and the **MCP Token Activation Notice**.
    9. Check the **I understand** checkbox, and click **Allow**.
    10. You can now access Airbridge data directly in Claude.
  </Accordion>

  <Accordion title="Claude Code">
    MCP is available on Pro, Max, Team, and Enterprise plans. For Team and Enterprise plans, the Owner must first add the connector to the organization.

    1. Open your terminal.
    2. Run the following command to add the Airbridge MCP server globally:
       ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
       claude mcp add -t http -s user airbridge https://mcp.airbridge.io/mcp
       ```
    3. When asked for approval, select **Yes**.
    4. Once the server is added, exit the conversation and return to the terminal.
    5. Open Claude Code and run:
       ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
       /mcp
       ```
    6. Select **Airbridge** from the list of MCP servers.
    7. Select **Authenticate.**
    8. Sign in to Airbridge on the sign-in page that appears.
    9. Review the tools you’re granting access to and the **MCP Token Activation Notice**.
    10. Check the **I understand** checkbox, and click **Allow**.
    11. You can now access Airbridge data directly in Claude Code.
  </Accordion>

  <Accordion title="ChatGPT">
    MCP is available on Plus, Pro, Business, Enterprise, and Edu plans. For Business, Enterprise, and Edu plans, the Owner must first enable **Developer Mode** and grant Developer Mode access to individual accounts.

    1. Go to [chatgpt.com](https://chatgpt.com) or open the ChatGPT app.
    2. Click your profile icon in the bottom-left corner.
    3. Go to **\[Settings]>\[Apps]** and click **Advanced Settings**.
    4. Enable **Developer Mode**.
    5. Click **Create App** and enter the following Airbridge MCP details:
       1. **Name:** Airbridge
       2. **MCP server URL:** [https://mcp.airbridge.io/mcp](https://mcp.airbridge.io/mcp)
       3. **Authentication:** OAuth
    6. Click **Create**.
    7. Back on the **\[Apps]** page, find and click **Airbridge**.
    8. Sign in to Airbridge on the sign-in page that appears.
    9. Review the tools you’re granting access to and the **MCP Token Activation Notice**.
    10. Check the **I understand** checkbox, and click **Allow**.
    11. You can now access Airbridge data directly in ChatGPT.
  </Accordion>

  <Accordion title="Codex CLI or IDE extension">
    1. Open your terminal.
    2. Run the following command to add the Airbridge MCP server:
       ```bash lines theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
       codex mcp add airbridge --url https://mcp.airbridge.io/mcp
       ```
    3. Sign in to Airbridge on the sign-in page that appears.
    4. Review the tools you’re granting access to and the **MCP Token Activation Notice**.
    5. Check the **I understand** checkbox, and click **Allow**.
    6. You can now access Airbridge data directly in Codex.

    <Info>
      **Note**

      The CLI and IDE extension share the same configuration. Once set up, you can switch between the two without repeating the setup process.
    </Info>
  </Accordion>
</AccordionGroup>

## Available Airbridge tools

* AI services support the same options and capabilities available on the Airbridge dashboard.
* Access to specific organizations, apps, and features follows your account's dashboard permissions.

### Tools always allowed

| Name                      | Description                                                               |
| ------------------------- | ------------------------------------------------------------------------- |
| Get Guide                 | Retrieves the content of a specific article in the Airbridge Help Center. |
| List Guides               | Lists articles in the Airbridge Help Center.                              |
| Search Dashboard Pages    | Searches the Airbridge dashboard by keyword.                              |
| Select App                | Lists accessible apps.                                                    |
| Setup SDK Deeplink        | Generates a platform-specific Airbridge SDK deeplink setup guide.         |
| Setup SDK Install         | Generates a platform-specific Airbridge SDK installation guide.           |
| Setup SDK Troubleshooting | Generates a platform-specific Airbridge SDK troubleshooting guide.        |

### Tools that need access

<AccordionGroup>
  <Accordion title="Read-only tools">
    | Name                               | Description                                                                                                    |
    | ---------------------------------- | -------------------------------------------------------------------------------------------------------------- |
    | Get Active Users Group By Metadata | Lists available Active Users report groupbys. Required before retrieving a report.                             |
    | Get Active Users Metrics Metadata  | Lists available Active Users report metrics. Required before retrieving a report.                              |
    | Get Active Users Report            | Retrieves an Active Users report.                                                                              |
    | Get Actuals Group By Metadata      | Lists available Actuals report groupbys. Required before retrieving a report.                                  |
    | Get Actuals Metrics Metadata       | Lists available Actuals report metrics. Required before retrieving a report.                                   |
    | Get Actuals Report                 | Retrieves an Actuals report.                                                                                   |
    | Get App Info                       | Retrieves Airbridge app details.                                                                               |
    | Get Deeplink Android               | Retrieves Android HTTP deeplink (App Link) settings.                                                           |
    | Get Deeplink iOS                   | Retrieves iOS HTTP deeplink (Universal Link) settings.                                                         |
    | Get Deeplink URI Schemes           | Retrieves Android and iOS deeplink URI schemes.                                                                |
    | Get Organization Info              | Retrieves organization details.                                                                                |
    | Get Organization Plans             | Retrieves plan and billing details for an organization.                                                        |
    | Get Raw Export URL                 | Exports raw data and provides a CSV download link.                                                             |
    | Get Retention Events Metadata      | Lists start events and return events available in the Retention report. Required before retrieving a report.   |
    | Get Retention Group By Metadata    | Lists available Retention report groupbys. Required before retrieving a report.                                |
    | Get Retention Measurement Options  | Lists measurement options available in the Retention report. Required before retrieving a report.              |
    | Get Retention Report               | Retrieves a Retention report.                                                                                  |
    | Get Retention Types Metadata       | Lists retention types available in the Retention report. Required before retrieving a report.                  |
    | Get Revenue Events Metadata        | Lists start events and revenue events available in the Revenue report. Required before retrieving a report.    |
    | Get Revenue Group By Metadata      | Lists available Revenue report groupbys. Required before retrieving a report.                                  |
    | Get Revenue Metrics Metadata       | Lists available Revenue report metrics and sub-metrics. Required before retrieving a report.                   |
    | Get Revenue Report                 | Retrieves a Revenue report.                                                                                    |
    | Get Tracking Link                  | Retrieves details of a specific tracking link.                                                                 |
    | List Organization Apps             | Lists Airbridge apps. Supports listing by organization when your account has access to multiple organizations. |
    | List Tracking Links                | Lists tracking links.                                                                                          |
    | Search App Store                   | Searches for apps in the app stores by keyword.                                                                |
  </Accordion>

  <Accordion title="Write/delete tools">
    <Danger>
      **Attention**

      These tools make direct changes to your Airbridge dashboard. Write/delete tools also include read access.
    </Danger>

    | Name                        | Description                                                                   |
    | --------------------------- | ----------------------------------------------------------------------------- |
    | Update App Platforms        | Updates app platform details (Android, iOS, Website) registered in Airbridge. |
    | Update Deeplink Android     | Updates Android HTTP deeplink (App Link) settings.                            |
    | Update Deeplink iOS         | Updates iOS HTTP deeplink (Universal Link) settings.                          |
    | Update Deeplink URI Schemes | Updates Android and iOS deeplink URI schemes.                                 |
  </Accordion>

  <Accordion title="Credential access tools">
    <Danger>
      **Attention**

      Allowing access to these tools sends your credentials to the AI service provider's server. Depending on your AI service settings, this data may be used for model training.
    </Danger>

    | Name          | Description                                      |
    | ------------- | ------------------------------------------------ |
    | Get App Token | Retrieves the app SDK token of an Airbridge app. |
    | Get Web Token | Retrieves the web SDK token of an Airbridge app. |
  </Accordion>
</AccordionGroup>

<link rel="alternate" hrefLang="en" href="https://help.airbridge.io/en/guides/mcp" />

<link rel="alternate" hrefLang="ko" href="https://help.airbridge.io/ko/guides/mcp" />
