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.
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.
Log in
Send
/webloginto 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.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/mcpAuthenticate
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
- Open Settings → Connectors and choose Add custom connector.
- Name it Topaze, paste the server address, and choose Add.
- 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.
- 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
- Then type /mcp in Claude Code, pick topaze, and sign in.
- Add
--scope userto have it in every project, or--scope projectto share it with the repo in .mcp.json.
Source: Claude Code docs
ChatGPT
ChatGPT web and desktop app
- Open Settings → Apps → Advanced settings and turn on Developer mode.
- Back in Settings → Apps, choose Create.
- Name it Topaze, paste the server address, set authentication to OAuth, confirm that you trust it, and choose Create.
- 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.
- 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
- 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.
- Type /mcp inside Codex to check Topaze is listed.
Source: OpenAI Codex docs
Codex: config file
- Add this to
~/.codex/config.toml:
[mcp_servers.topaze] url = "https://mcp.topaze.xyz/mcp"
- 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
- 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. - /mcp lists Topaze and its tools.
Source: Gemini CLI docs
Gemini CLI: config file
- Add Topaze to
~/.gemini/settings.json:
{
"mcpServers": {
"topaze": { "httpUrl": "https://mcp.topaze.xyz/mcp" }
}
}- 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
- Go to grok.com/connectors and choose New Connector → Custom.
- Name it Topaze and paste the server address.
- 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.
- Grok lists Topaze’s tools, and they are available in your chats.
Source: xAI docs: connectors
Grok Bot: just tell it
- 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.
- 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.
Grok Build: command line
grok mcp add --transport http topaze https://mcp.topaze.xyz/mcp
- 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.
grok mcp doctor topazechecks 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
- 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.
- 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
- Open Settings → MCP and add a server.
- Name it topaze, choose Streamable HTTP, and paste the server address.
- 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. openclaw mcp doctor topaze --probechecks that it answers.
Source: OpenClaw docs: MCP
Tab
Tab (tab.bot) on iMessage or WhatsApp: just tell it
- 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.
- 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
- Open Intelligence → Connectors and choose Add connector.
- Switch to the Custom MCP Connector tab, name it Topaze, and paste the server address.
- 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.
- In a chat, turn Topaze on in the tools menu.
Source: Mistral Help Center · Mistral docs
Cursor
Cursor
- Open Cursor Settings → MCP and choose Add new MCP server, which opens
~/.cursor/mcp.json(or use.cursor/mcp.jsonin a project). - Add Topaze:
{
"mcpServers": {
"topaze": { "url": "https://mcp.topaze.xyz/mcp" }
}
}- 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
- Open the command palette and run MCP: Add Server.
- Choose HTTP, paste the server address, name it topaze, and save it to Global or Workspace.
- 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.
- 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
- Add Topaze to
.vscode/mcp.jsonin your workspace:
{
"servers": {
"topaze": { "type": "http", "url": "https://mcp.topaze.xyz/mcp" }
}
}- 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
- 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.
- 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.
- Muse builds the connector itself and asks how much it may do without checking with you.
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.