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

# Lorikeet MCP Server

> Connect to your Lorikeet account from ChatGPT, Claude, and Claude Code using the Model Context Protocol.

The Lorikeet MCP server allows AI tools like ChatGPT and Claude to access your Lorikeet account data directly, including workflows, tools, integrations, knowledge base articles, and more.

<Info>
  Looking to connect an external MCP server **to** Lorikeet as a tool provider? See the [External MCP Servers](/tools/mcp) page instead.
</Info>

Once connected, you can:

* **Diagnose tickets** - trace workflow execution and identify root causes
  > "Pull up ticket #12345. What went wrong and why did the customer get escalated?"
* **Audit knowledge bases** - analyze articles at scale, find gaps, and spot quality issues
  > "Review all our knowledge base articles. Which ones are outdated, which topics have gaps, and are there any quality issues?"
* **Explore your setup** - inspect workflows, tools, and integrations
  > "Give me a summary of what integrations are configured."
* **Build workflows** - create and iterate on workflows using natural language
  > "Create a new natural language workflow that handles refund requests by checking order status, verifying the return window, and processing the refund."
* **Test tools** - run and validate tool configurations directly from your AI assistant
  > "Test the 'get-order-status' tool with order ID 98765 and check if the response matches what we expect."
* **Run simulations** - test workflows against different customer scenarios
  > "Set up a simulation batch for the refund workflow with 3 different customer scenarios — a valid refund, an expired return window, and a missing order — and run it."

[MCP (Model Context Protocol)](https://modelcontextprotocol.io/introduction) is an open standard for connecting AI tools to external data sources and services.

## MCP server URL

Use a single, region-agnostic endpoint regardless of where your Lorikeet account is hosted:

```
https://mcp.lorikeetcx.ai
```

Authentication routes traffic to your account's region automatically.

## Setup

<Tabs>
  <Tab title="ChatGPT">
    ### Prerequisites

    * Access to [ChatGPT](https://chatgpt.com) with a Team, Business, or Enterprise subscription
    * **Workspace Admin access** is required for the initial setup (Steps 1–5). Once complete, all workspace members can use the app.

    ### Connect

    <Steps>
      <Step title="Open Workspace Settings">
        Go to [chatgpt.com](https://chatgpt.com), click your profile icon in the bottom-left corner, and select **Workspace settings**.
      </Step>

      <Step title="Create a new app">
        In the admin panel, click the **Create** button.
      </Step>

      <Step title="Configure the app">
        Fill in the app configuration:

        * **Name**: `Lorikeet`
        * **Description**: `Access your Lorikeet account.`
        * **MCP Server URL**: `https://mcp.lorikeetcx.ai`
        * **Authentication**: Select `OAuth`

        Click **Create** to proceed.
      </Step>

      <Step title="Authorize">
        You will be redirected to the Lorikeet authorization page. Sign in to your Lorikeet account and click **Authorize**.
      </Step>

      <Step title="Publish the app">
        After authorization, the Lorikeet app will appear in the **Drafts** section. Click on the app, then click **Publish** to make it available to your workspace.
      </Step>

      <Step title="Use the app">
        Workspace members can now use the Lorikeet app in their conversations:

        1. Start a new chat
        2. Click the **+** button near the message input
        3. Click **More** to see all available apps
        4. Select **Lorikeet**
      </Step>
    </Steps>

    ### Troubleshooting

    For troubleshooting connection issues, refer to the [ChatGPT apps docs](https://help.openai.com/en/articles/11487775-apps-in-chatgpt).

    If you're still having trouble, reach out to the [Lorikeet team](mailto:support@lorikeetcx.ai).
  </Tab>

  <Tab title="Claude">
    ### Prerequisites

    * Access to [Claude](https://claude.ai) with a Pro, Team, or Enterprise subscription

    ### Connect

    <Steps>
      <Step title="Open Settings">
        Go to [claude.ai](https://claude.ai) and click your profile icon in the bottom-left corner, then select **Settings**.
      </Step>

      <Step title="Add a Custom Connector">
        In Settings, click the **Connectors** tab, then click **+ Add Custom Connector**.

        <Warning>
          You may need **admin access** to add custom connectors. Contact your workspace admin if this option is not available.
        </Warning>
      </Step>

      <Step title="Configure the connector">
        Fill in the connector form:

        * **Name**: `Lorikeet`
        * **Description**: `Access your Lorikeet account.`
        * **URL**: `https://mcp.lorikeetcx.ai`

        Click **Add** to proceed. Claude will automatically discover the OAuth endpoints.
      </Step>

      <Step title="Authorize">
        You will be redirected to the Lorikeet authorization page. Sign in to your Lorikeet account and click **Authorize**.
      </Step>

      <Step title="Verify">
        Once connected, the Lorikeet connector will appear in your Connectors list. Try asking Claude:

        ```
        What Lorikeet account am I connected to?
        ```
      </Step>
    </Steps>

    ### Troubleshooting

    For troubleshooting connection issues, refer to the [Claude connector docs](https://support.claude.com/en/articles/11503834-building-custom-connectors-via-remote-mcp-servers).

    If you're still having trouble, reach out to the [Lorikeet team](mailto:support@lorikeetcx.ai).
  </Tab>

  <Tab title="Claude Code">
    ### Prerequisites

    * [Claude Code](https://code.claude.com) installed on your machine

    ### Connect

    Run the following command in your terminal:

    ```bash theme={null}
    claude mcp add --scope user --transport http lorikeet https://mcp.lorikeetcx.ai
    ```

    Then authenticate by running `/mcp` inside Claude Code and following the browser login flow.

    ### Verify

    Once connected, ask Claude Code:

    ```
    What Lorikeet account am I connected to?
    ```

    ### Troubleshooting

    For troubleshooting connection issues, refer to the [Claude Code MCP docs](https://code.claude.com/docs/en/mcp).

    If you're still having trouble, reach out to the [Lorikeet team](mailto:support@lorikeetcx.ai).
  </Tab>
</Tabs>

## Technical details

| Property       | Value                        |
| -------------- | ---------------------------- |
| Protocol       | Model Context Protocol (MCP) |
| Transport      | Streamable HTTP              |
| Authentication | OAuth 2.0 with PKCE          |
| Token Lifetime | 1 hour (auto-refresh)        |
