Help Center

Connect Claude, Cursor or another AI tool to your business

mcp.smoo.ai puts your CRM, calendar, files, analytics and knowledge base inside the AI tool you already use.

Smoo AI runs a hosted MCP server at mcp.smoo.ai. MCP is the open standard that lets an AI assistant call real tools, so connecting it means Claude (or Cursor, or anything else that speaks MCP) can look things up in your business and act on them.

It is the same tool set Smooth Operator uses, and it obeys the same rules: your token decides your org, and your role decides which tools you get. Connecting grants the assistant nothing you do not already have.

Nothing to install and nothing to run — it is a URL.

How to

  1. 1

    Pick how you will authenticate.

    Claude Desktop, claude.ai and ChatGPT can sign you in with one click. Everything else uses an API key you paste as a header.

  2. 2

    For Claude Desktop / claude.ai: add a custom connector pointing at https://mcp.smoo.ai

    Settings → Connectors → Add custom connector. A browser window opens, you sign in to Smoo, and you pick which organization the connector should act on. That choice is what scopes every later call.

  3. 3

    For ChatGPT: add a connector with the same URL — https://mcp.smoo.ai

    Settings → Connectors (developer mode may need enabling under Advanced). The same sign-in and org-picker flow runs in your browser.

  4. 4

    For Claude Code: claude mcp add --transport http smoo https://mcp.smoo.ai/mcp --header "Authorization: Bearer YOUR_KEY"

    Create the key first under Developers → API Keys. Then run /mcp inside Claude Code to confirm the tools loaded.

  5. 5

    For Cursor and other config-file clients, add an entry with the same URL and header.

    Most use an mcp.json with { "url": "https://mcp.smoo.ai/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } }. Check your client's docs for the exact filename.

  6. 6

    Ask your assistant something only your business would know.

    "How many contacts are in my CRM?" is the fastest proof it worked.

Ask Smooth Operator

  • “How many contacts, companies and deals are in my CRM?”
  • “What is my pipeline worth right now?”
  • “Search my knowledge base for our refund policy”
  • “What is booked this week?”
  • “Which of my deals are in negotiation?”

If something goes wrong

"Couldn't connect to the server. Check that the URL points to a valid MCP server."
Try the other form of the URL — both https://mcp.smoo.ai and https://mcp.smoo.ai/mcp are valid endpoints. If both fail, the token is being rejected rather than the URL.
ChatGPT will not connect.
Not supported yet. The one-click sign-in only accepts callbacks on Anthropic-controlled hosts, and ChatGPT's connector callback is not among them. There is no key-based fallback for ChatGPT custom connectors today.
Claude Desktop says automatic client registration is not supported.
That message means it could not reach the registration endpoint — usually a stale or mistyped URL. Remove the connector and re-add it with exactly https://mcp.smoo.ai.
It connected once and then stopped working.
Sign in again through the connector. If you have not opened the connector in over a month, the org it was bound to can lapse and every tool starts returning "not found".
Fewer tools than you expected.
The tool list is filtered by your plan and your role, exactly like the dashboard sidebar. An org API key gets full org access; your own sign-in gets your own permissions.
It cannot read an image you pasted.
Tool arguments are text. Upload the file to Smoo first and refer to it, rather than pasting a picture into the chat.

Related