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

# Install Enrichley in ChatGPT (early access)

> A visual guide to installing the Enrichley skill and MCP connector from its public GitHub marketplace before the public ChatGPT directory release.

This guide installs the Enrichley plugin in the **ChatGPT desktop app for macOS**. The plugin bundles both the Enrichley MCP connector and the `using-enrichley` skill, so ChatGPT gets the tools and the workflow instructions together.

The setup takes about five minutes. The final verification is a free account-status check and does not spend Enrichley credits.

<Warning>
  This is an **early-access repository install** while Enrichley is not yet listed in ChatGPT's public Plugins Directory. OpenAI describes local and repository marketplaces as testing and team-distribution sources, and their availability can vary by surface. Use the ChatGPT desktop app for this setup.
</Warning>

<Note>
  Want the shortest setup and only need Enrichley's tools? [Connect Enrichley directly to ChatGPT](/mcp/chatgpt-connector-install). The direct setup uses ChatGPT's visual interface and does not require Terminal, but it does not include the bundled `using-enrichley` workflow skill.
</Note>

## Before you start

Have these ready:

* the latest [ChatGPT desktop app for macOS](https://chatgpt.com/download/);
* a ChatGPT account with access to **Plugins**;
* your Enrichley account; and
* Terminal on your Mac.

<Note>
  You do not need to create a connector manually or paste the MCP URL into ChatGPT. The Enrichley repository already packages the registered connector and skill together.
</Note>

## Add the Enrichley marketplace

<Steps>
  <Step title="Quit ChatGPT completely">
    In the menu bar, choose **ChatGPT → Quit ChatGPT**. Closing only the window is not enough because ChatGPT reads marketplace changes when the app starts.
  </Step>

  <Step title="Add the public Enrichley marketplace">
    Open Terminal and run:

    ```bash theme={null}
    "/Applications/ChatGPT.app/Contents/Resources/codex" plugin marketplace add \
      getEnrichley/enrichley-mcp-plugin --ref main
    ```

    A successful command reports that the `enrichley` marketplace was added. This command downloads only the public plugin repository; it does not connect your Enrichley account or spend credits.
  </Step>

  <Step title="Reopen ChatGPT">
    Open the ChatGPT desktop app, select **Plugins**, then choose **Personal**.

    Under the **Enrichley** marketplace section, open **Enrichley**. Choose the entry with the green Enrichley logo, not a development connector with a similar name.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/01-find-enrichley.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=a0e33aed886cf82b8a5e23c0da830446" alt="ChatGPT Personal plugins showing the Enrichley repository plugin and its Install button" width="790" height="155" data-path="images/mcp/chatgpt-plugin/01-find-enrichley.png" />
  </Step>
</Steps>

## Install the plugin

<Steps>
  <Step title="Review the bundle and select Install plugin">
    Confirm the page shows:

    * **Enrichley**;
    * **Apps 1** with the Production Enrichley MCP connector; and
    * **Skills 1** with **Using Enrichley**.

    Then select **Install plugin**.

    <Note>
      The version number may be newer than the screenshots. Install the newest version ChatGPT displays.
    </Note>

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/02-review-plugin.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=6275078678a27736d973d58fc7c3c038" alt="Enrichley plugin details highlighting Apps 1, Skills 1, and Install plugin" width="770" height="820" data-path="images/mcp/chatgpt-plugin/02-review-plugin.png" />
  </Step>

  <Step title="Continue to Enrichley">
    Review ChatGPT's connection notice and select **Continue to Enrichley**.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/03-connect-enrichley.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=1983478ec8c6ac5516c902bf29cd8a84" alt="ChatGPT Connect Enrichley dialog highlighting Continue to Enrichley" width="500" height="525" data-path="images/mcp/chatgpt-plugin/03-connect-enrichley.png" />
  </Step>
</Steps>

## Connect your Enrichley account

<Steps>
  <Step title="Allow the identity connection">
    Your normal web browser opens Enrichley's sign-in and consent page. Sign in if asked, review the request, and select **Allow**.

    The account identity in this screenshot is intentionally hidden.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/04-allow-enrichley.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=8cd1e25906f5d6117464ba2926c98311" alt="Enrichley identity consent page with the account identity hidden and Allow highlighted" width="440" height="600" data-path="images/mcp/chatgpt-plugin/04-allow-enrichley.png" />
  </Step>

  <Step title="Allow ChatGPT to connect">
    Enrichley shows the exact access ChatGPT requested. Review the permissions, then select **Allow**.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/05-authorize-chatgpt.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=773f87839d7edb3e5f587ed17a7ab652" alt="Enrichley authorization page showing the requested scopes and Allow button" width="560" height="754" data-path="images/mcp/chatgpt-plugin/05-authorize-chatgpt.png" />
  </Step>

  <Step title="Return to the ChatGPT app">
    If your browser asks whether to open ChatGPT, choose **Open ChatGPT** immediately. This native browser prompt completes the handoff; leaving it unanswered can cause **Plugin installation timed out**.

    Return to ChatGPT and use the app state as the source of truth. Under **Apps 1**, the Enrichley connector must show **Connected** rather than **Connect** or **Continue connecting**.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/06-connected.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=90fd78a2e4546420393e4e31fa428673" alt="Enrichley plugin page highlighting the connected Production app and enabled Using Enrichley skill" width="790" height="820" data-path="images/mcp/chatgpt-plugin/06-connected.png" />
  </Step>
</Steps>

## Verify the installation

<Steps>
  <Step title="Start a fresh Work chat">
    Start a new ChatGPT conversation and select **Work** at the top. Plugin and tool catalogs are fixed when a conversation begins, so do not reuse a chat that was open before installation.

    <Warning>
      Use **Work** when you want Enrichley's interactive Preview, Run Quote, Download, Error, and Account cards. A plain **Chat** conversation can return model-visible tool results without displaying the MCP app card.
    </Warning>
  </Step>

  <Step title="Attach Enrichley to the Work chat">
    Below the composer, select **Plugins**. Search for **Enrichley**, then select it. A green **Enrichley** label appears in the composer when the plugin is attached.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/07-work-select-enrichley.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=75a22570e64cee17687039cc6e9023be" alt="ChatGPT Work with the Plugins picker filtered to Enrichley" width="730" height="680" data-path="images/mcp/chatgpt-plugin/07-work-select-enrichley.png" />
  </Step>

  <Step title="Run the free account check">
    Enter:

    > Check my Enrichley credit balance.

    Allow the first Enrichley tool call when ChatGPT asks. This calls `enrichley_get_account_status` and does not spend credits.

    ChatGPT should render the **Your Enrichley credits** card. The account values in this guide are intentionally hidden.

    <img src="https://mintcdn.com/enrichley/5s_UOig12bBYw18U/images/mcp/chatgpt-plugin/08-account-status-card.png?fit=max&auto=format&n=5s_UOig12bBYw18U&q=85&s=90d37f4b9b6b4761829b3f232eabca4f" alt="ChatGPT Work rendering the Enrichley account-status card with account values hidden" width="770" height="480" data-path="images/mcp/chatgpt-plugin/08-account-status-card.png" />
  </Step>

  <Step title="Confirm both parts are active">
    Setup is complete when ChatGPT renders the Enrichley account-status result and the Enrichley plugin page still shows:

    * the Production Enrichley connector as **Connected**; and
    * the **Using Enrichley** skill enabled.
  </Step>
</Steps>

## Keep the early-access plugin updated

When Enrichley publishes an update, quit ChatGPT, run:

```bash theme={null}
"/Applications/ChatGPT.app/Contents/Resources/codex" plugin marketplace upgrade enrichley
```

Then reopen ChatGPT. If the plugin page still shows an older version, remove and reinstall **Enrichley** from the Enrichley marketplace section; your Enrichley account connection can then be reauthorized.

## If something does not match

* **No Personal tab or marketplace section:** update the ChatGPT desktop app. Repository marketplaces are not exposed on every ChatGPT surface or account.
* **Install plugin is disabled:** quit ChatGPT, run the marketplace command again, and reopen the app.
* **The browser does not return to ChatGPT:** switch back to ChatGPT first. If the Production app says **Connected**, the setup succeeded and the browser tab can be closed.
* **Plugin installation timed out:** start the install again with ChatGPT already open and accept the browser's native **Open ChatGPT** prompt promptly. If no prompt appears, allow external app links for ChatGPT in your browser, then retry once.
* **Connect or Continue connecting remains after authorization:** the browser-to-desktop handoff did not complete. Reopen ChatGPT, open **Plugins → Enrichley**, retry the connection once, and accept **Open ChatGPT**. Do not create a manual MCP connector.
* **Two Enrichley tiles appear after connecting:** ChatGPT can represent the Git marketplace bundle and its connected Production app wrapper as separate tiles. This is still one MCP app connection. Keep the Git marketplace bundle and the connected Production app; remove only entries labeled **Dev** or **Preview**.
* **An old chat cannot see Enrichley:** start a new chat after the connector shows Connected.
* **The tool works but no card appears:** start a fresh **Work** chat, then select **Plugins → Enrichley** below the composer before sending the request.

For more help, see [MCP troubleshooting](/mcp/troubleshooting) or email [support@enrichley.io](mailto:support@enrichley.io).

<CardGroup cols={2}>
  <Card title="Install in Claude" icon="plug" href="/mcp/claude-plugin-install">
    Follow the visual install guide for Claude web or desktop.
  </Card>

  <Card title="Tools and resources" icon="wrench" href="/mcp/tools">
    See every Enrichley tool, its permissions, and its credit cost.
  </Card>
</CardGroup>
