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

# Authentication

> How Tyms MCP OAuth works and which Client ID to use for each platform.

Tyms MCP uses **OAuth**. You sign in with your Tyms account and approve access for a specific business. You do **not** paste API secret keys into Claude or ChatGPT.

## Client ID by platform

When an MCP client asks for a **Client ID** after you enter the MCP URL, use the ID that matches your platform:

| Platform                                            | Client ID                |
| --------------------------------------------------- | ------------------------ |
| **Claude** (Claude.ai, Claude Desktop, Claude Code) | `usetyms-mcp-claude`     |
| **ChatGPT**                                         | `usetyms-mcp-chatgpt`    |
| **Perplexity**                                      | `usetyms-mcp-perplexity` |
| **Any other client** (Cursor, etc.)                 | `usetyms-mcp-client`     |

<Important>
  Enter the Client ID for **your** platform exactly as shown. Do not invent a different value. If your app is not Claude, ChatGPT, or Perplexity, use `usetyms-mcp-client`.
</Important>

| Field                | Value                          |
| -------------------- | ------------------------------ |
| **Auth type**        | OAuth                          |
| **Read-only URL**    | `https://mcp.usetyms.com`      |
| **Read + write URL** | `https://mcp.usetyms.com/full` |

## How authentication works

<Steps>
  <Step title="Connect to the MCP URL">
    Your MCP client connects to the Tyms MCP URL ([read-only or full](/mcp/endpoints)).
  </Step>

  <Step title="Provide the Client ID if asked">
    Enter the Client ID for your platform from the table above.
  </Step>

  <Step title="Complete Tyms OAuth">
    The client opens Tyms’ OAuth flow. You sign in and approve access for a business.
  </Step>

  <Step title="Use the connected business">
    Tyms issues a short-lived connection for that client. Tool calls run as that connected business.
  </Step>
</Steps>

## What is shared (and what is not)

* Your Tyms credentials are **not** shared with Claude, ChatGPT, or Perplexity as raw API keys.
* The client receives a bridge token; Tyms keeps the upstream business tokens server-side.
* The assistant only sees data for the **business you approved** during OAuth.

## Tips

* Prefer the [read-only endpoint](/mcp/endpoints) unless you need write tools.
* Review tool calls before approving writes in your MCP client.
* If a client should no longer be connected, revoke access from your Tyms / integration settings.

For client-specific setup, see [Claude.ai](/mcp/clients/claude-ai), [Claude Desktop](/mcp/clients/claude-desktop), [Claude Code](/mcp/clients/claude-code), [ChatGPT](/mcp/clients/chatgpt), and [Perplexity](/mcp/clients/perplexity).