MCP Server
Work with your Raqi workspace from Claude, ChatGPT, Manus and other AI assistants.
Raqi's MCP server lets Claude, ChatGPT or another MCP-compatible assistant work with your workspace through chat, so you can manage most of your Raqi work from the conversation. It works with Claude.ai custom connectors, Claude Code, ChatGPT connectors in Developer mode and Manus custom MCP servers.
Important: The MCP connector is a paid feature, from the Starter plan. A Free workspace cannot create or use an MCP connection.
What You Can Do From the Chat
Once connected, you can ask things like "list my contacts from last week" or "turn on my Instagram comment-to-DM workflow". Your assistant can:
Tip: Nothing can be deleted through MCP, broadcasts are saved as drafts for you to send, and it cannot connect or disconnect channels, manage billing or invite team members.
- Read contacts, conversations and analytics
- Manage workflows, AI agents and Auto-DMs, including creating automations from templates
- Schedule posts and update your brand profile and content ideas
- Generate images and videos in the Ads Studio, using the same credits as the app
Setup (Claude.ai)
Connect Raqi to Claude.ai in three steps:
- 1. In Raqi, open Integrations & API and copy the address on the MCP server card: https://api.raqi.io/api/mcp.
- 2. In Claude, open Settings > Connectors and add a custom connector with that URL.
- 3. When raqi.io asks, sign in, choose the workspace, tick the permissions to grant and click Allow.
Setup (ChatGPT)
ChatGPT adds Raqi through Developer mode, which needs a paid ChatGPT plan:
- 1. In ChatGPT, open Settings > Apps and Connectors > Advanced and turn on Developer mode.
- 2. Create a connector with the address https://api.raqi.io/api/mcp and choose OAuth.
- 3. When raqi.io asks, sign in, choose the workspace, tick the permissions to grant and click Allow.
- 4. In a chat, turn on the Raqi connector and ask for what you need.
Setup (Manus)
Manus adds Raqi as a custom MCP server:
- 1. In Manus, open Connectors and add a custom MCP server with the address https://api.raqi.io/api/mcp.
- 2. Sign in with Raqi if Manus asks. If it asks for a header instead, click Get MCP URL on the MCP server card and add
Authorization: Bearer your_auth_token. - 3. Ask Manus to list your Raqi workspaces to check the connection.
Setup (Claude Code)
On the MCP server card, click Get MCP URL and create it. The dialog shows a one-time auth token for Claude Code. Copy it right away (it stays masked afterwards), then run:
claude mcp add raqi --transport http https://api.raqi.io/api/mcp \
--header "Authorization: Bearer your_auth_token"Several Workspaces
On the Scale and Business plans, one connection can reach several workspaces of your organization, so you never need a separate connector per workspace. On the consent screen, tick them under Also connect (or Select all). The workspace chosen above stays the default; ask the assistant to use another one by name. To add workspaces to a connection that already works, disconnect and reconnect it in the assistant, tick them, then start a new chat. The Claude Code token reaches only the workspace it was created in.
Permissions and Revocation
The consent screen asks for each permission (workspace, contacts, conversations, workflows and more), so you approve exactly what each app can do. To cut access, open Settings > Workspace > MCP connections and click Revoke. This ends all of that connection's tokens at once.
Security
Access tokens are short-lived (1 hour). Refresh tokens last 30 days and are stored as SHA-256 hashes. Every tool call runs only in a workspace approved for that connection: the one chosen on the consent screen, or another workspace of the same organization ticked there on the Scale and Business plans. A workspace that was not approved can never be read.
Was this article helpful?