Get started

Set up Topaze in 5 minutes

Create an account, confirm it on WhatsApp, log in, and connect the agents you use: Claude, ChatGPT, Codex, Gemini, Grok, OpenClaw, Tab, Le Chat, Cursor, Copilot, Muse. Every one connects to the same address and signs in with OAuth.

  1. Sign up

    Create your Topaze account at app.topaze.xyz. It takes a minute.

    Sign up
  2. Confirm on WhatsApp

    Sign-up ends with a message for you to send to Topaze on WhatsApp, at +44 7477 156095. Send it as it is: that confirms your account, and from then on you can talk to Topaze, and to your agents, from your phone.

  3. Log in

    Send /weblogin to Topaze on WhatsApp. It answers with a link that logs you in: open it in the browser on the computer or phone where you use your agent.

  4. Connect your agent

    Add the Topaze MCP server to each agent you use. Every agent connects to the same address, https://mcp.topaze.xyz/mcp, and signs in with OAuth. Pick your agent below for the exact steps.

    https://mcp.topaze.xyz/mcp
  5. Authenticate

    Your agent opens a Topaze sign-in window. Approve the connection with OAuth, and your agent has a memory: everything it learns is there for your other agents, and for the people you share a project with.

Step 4

Connect your agent

Paste the server address where your agent asks for it. Pick the way you use your agent: an app, a command line or a config file.

Claude

Claude.ai: web, desktop and mobile app

  1. Open Settings → Connectors and choose Add custom connector.
  2. Name it Topaze, paste the server address, and choose Add.
  3. Choose Connect. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  4. Start a new conversation: a connector added mid-conversation shows up in the next one.

Free plans allow one custom connector. On Team and Enterprise plans an Owner adds it first.

Source: Claude Help Center

Claude Code: local configuration

claude mcp add --transport http topaze https://mcp.topaze.xyz/mcp
  1. Then type /mcp in Claude Code, pick topaze, and sign in.
  2. Add --scope user to have it in every project, or --scope project to share it with the repo in .mcp.json.

Source: Claude Code docs

ChatGPT

ChatGPT web and desktop app

  1. Open Settings → Apps → Advanced settings and turn on Developer mode.
  2. Back in Settings → Apps, choose Create.
  3. Name it Topaze, paste the server address, set authentication to OAuth, confirm that you trust it, and choose Create.
  4. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  5. In a chat, open the + menu and turn Topaze on.

Developer mode needs a paid plan, and on Business and Enterprise plans an admin may have to allow it.

Source: OpenAI Help: connectors · Developer mode

Codex

Codex CLI and IDE extension: command

codex mcp add topaze --url https://mcp.topaze.xyz/mcp
codex mcp login topaze
  1. The second command opens your browser. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  2. Type /mcp inside Codex to check Topaze is listed.

Source: OpenAI Codex docs

Codex: config file

  1. Add this to ~/.codex/config.toml:
[mcp_servers.topaze]
url = "https://mcp.topaze.xyz/mcp"
  1. Run codex mcp login topaze. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: OpenAI Codex docs

Gemini

Gemini CLI: command

gemini mcp add --transport http topaze https://mcp.topaze.xyz/mcp
  1. Start Gemini and type /mcp auth topaze. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  2. /mcp lists Topaze and its tools.

Source: Gemini CLI docs

Gemini CLI: config file

  1. Add Topaze to ~/.gemini/settings.json:
{
  "mcpServers": {
    "topaze": { "httpUrl": "https://mcp.topaze.xyz/mcp" }
  }
}
  1. Start Gemini and type /mcp auth topaze. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: Gemini CLI docs

Grok

Grok on grok.com

  1. Go to grok.com/connectors and choose New Connector → Custom.
  2. Name it Topaze and paste the server address.
  3. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  4. Grok lists Topaze’s tools, and they are available in your chats.

Source: xAI docs: connectors

Grok Bot: just tell it

  1. Tell Grok Bot, in a chat:
Connect to the MCP server "topaze" at https://mcp.topaze.xyz/mcp
It uses HTTP and signs in with OAuth.
  1. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: Composio guide (no official page yet)

Grok Build: command line

grok mcp add --transport http topaze https://mcp.topaze.xyz/mcp
  1. The first time Grok Build uses Topaze it opens your browser. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  2. grok mcp doctor topaze checks the connection; /mcps in Grok Build shows it.

Source: xAI docs: Grok Build MCP servers

OpenClaw

OpenClaw on WhatsApp or another chat: just tell it

  1. Tell OpenClaw, in a chat:
Connect to the MCP server "topaze" at https://mcp.topaze.xyz/mcp
It uses HTTP and signs in with OAuth.
  1. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: OpenClaw docs: MCP

OpenClaw Control UI

  1. Open Settings → MCP and add a server.
  2. Name it topaze, choose Streamable HTTP, and paste the server address.
  3. Run openclaw mcp login topaze. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  4. openclaw mcp doctor topaze --probe checks that it answers.

Source: OpenClaw docs: MCP

Tab

Tab (tab.bot) on iMessage or WhatsApp: just tell it

  1. Tell Tab, in a chat:
Connect to the MCP server "topaze" at https://mcp.topaze.xyz/mcp
It uses HTTP and signs in with OAuth.
  1. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: tab.bot

Le Chat

Le Chat web and app

  1. Open Intelligence → Connectors and choose Add connector.
  2. Switch to the Custom MCP Connector tab, name it Topaze, and paste the server address.
  3. Choose Connect. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  4. In a chat, turn Topaze on in the tools menu.

Source: Mistral Help Center · Mistral docs

Cursor

Cursor

  1. Open Cursor Settings → MCP and choose Add new MCP server, which opens ~/.cursor/mcp.json (or use .cursor/mcp.json in a project).
  2. Add Topaze:
{
  "mcpServers": {
    "topaze": { "url": "https://mcp.topaze.xyz/mcp" }
  }
}
  1. Back in the MCP settings, choose Connect next to Topaze. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: Cursor docs

Copilot

GitHub Copilot in VS Code: command palette

  1. Open the command palette and run MCP: Add Server.
  2. Choose HTTP, paste the server address, name it topaze, and save it to Global or Workspace.
  3. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  4. In Copilot Chat, switch to Agent mode: Topaze’s tools appear under the tools button.

Source: VS Code docs

GitHub Copilot in VS Code: config file

  1. Add Topaze to .vscode/mcp.json in your workspace:
{
  "servers": {
    "topaze": { "type": "http", "url": "https://mcp.topaze.xyz/mcp" }
  }
}
  1. Choose Start above the entry. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.

Source: VS Code docs

Muse

Meta Muse: just tell it

  1. Tell Muse, in a chat:
Connect to the MCP server "topaze" at https://mcp.topaze.xyz/mcp
It uses HTTP and signs in with OAuth.
  1. Sign in to Topaze in the window that opens, and approve the connection. Not logged in? Send /weblogin to Topaze on WhatsApp and open the link it sends back.
  2. Muse builds the connector itself and asks how much it may do without checking with you.

Source: Parallel guide (no official page yet)

These instructions are to the best of our knowledge, but they change quite rapidly. Each one links to where we found it, the vendor’s own documentation wherever there is one.