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

# Connect ChatGPT

> Install the Rings app in ChatGPT, or add the MCP server yourself in developer mode

## Option 1 — install the Rings app (fastest)

Rings is published in the ChatGPT app directory. Nothing to configure.

<Card title="Install Rings AI in ChatGPT" icon="download" href="https://chatgpt.com/apps/rings-ai/asdk_app_6a32575772f481918f88503de126c411">
  Open the listing, click **Connect**, and sign in with your Rings account.
</Card>

Use it by naming Rings in a prompt, or by picking it from the tools menu in the
composer.

## Option 2 — add it yourself in developer mode

Use this when you want the full tool surface, including write actions, under
your own workspace's controls.

<Note>
  Developer mode and full MCP support are available on ChatGPT **Business,
  Enterprise, and Edu** plans, on ChatGPT web. On Business, only admins and
  owners can enable it; on Enterprise and Edu, admins can grant it to specific
  members via RBAC.
</Note>

<Steps>
  <Step title="Enable developer mode">
    **Admins and owners** turn it on in **Workspace Settings → Permissions &
    Roles → Connected Data → Developer mode / Create custom MCP connectors**.

    Each person then enables it for their own account under **Settings → Apps →
    Advanced Settings**.
  </Step>

  <Step title="Create the app">
    Go to **Settings → Apps → Create** (admins can also do this from
    **Workspace settings → Apps → Create**).
  </Step>

  <Step title="Fill in the server details">
    | Field          | Value                                                          |
    | -------------- | -------------------------------------------------------------- |
    | Name           | `Rings`                                                        |
    | Description    | Relationship intelligence — people, companies, activity, deals |
    | MCP Server URL | `https://production-api.joinrings.com/mcp`                     |
    | Authentication | OAuth                                                          |
  </Step>

  <Step title="Scan tools">
    Click **Scan Tools**. Complete the Rings OAuth prompt when it appears, then
    wait for the scan to list the tools.
  </Step>

  <Step title="Create">
    Click **Create**. The app appears under **Settings → Apps → Enabled Apps**
    with a **Dev** label, and as a draft in **Workspace settings → Apps →
    Drafts**.
  </Step>

  <Step title="Publish it to the workspace">
    An admin or owner opens **Workspace settings → Apps → Drafts** and clicks
    **Publish**. Enterprise and Edu admins can use **Configure Actions** to
    choose which tools are allowed and **Configure Access** to pick which groups
    get the app.
  </Step>
</Steps>

<Note>
  ChatGPT loses access when the first token expires unless the server issues
  refresh tokens. Rings advertises the `refresh_token` grant in its
  authorization-server metadata and issues refresh tokens, so no extra
  configuration is needed on your side.
</Note>

## Option 3 — the OpenAI API

Point the Responses API straight at the Rings MCP server:

```bash theme={null}
curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.6",
    "input": "Who on our team is closest to Acme Corp?",
    "tools": [
      {
        "type": "mcp",
        "server_label": "rings",
        "server_description": "Rings relationship intelligence graph",
        "server_url": "https://production-api.joinrings.com/mcp",
        "authorization": "YOUR_OAUTH_ACCESS_TOKEN",
        "require_approval": "never"
      }
    ]
  }'
```

* `authorization` takes an OAuth access token. OpenAI does not store it, so send
  it on every request.
* Narrow the surface with `allowed_tools: ["tool_a", "tool_b"]` — get the exact
  names from an MCP `list_tools` request.
* Leave `require_approval` at its default when the model can call write tools.