> ## 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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.