MCP Overview

MCP (Model Context Protocol) lets AI chat tools connect to external services. Orki provides two MCP servers, so your assistant can both read the documentation and operate your workspace.

Server	What it gives you	Auth
Orki Docs	Answers about Orki, grounded in this documentation	None
Orki App	Your actual account — agents, customers, campaigns, tools, and more	Required

The Docs server is the fastest thing to set up, and it's the one worth adding first: instead of searching the docs, you ask your assistant and it cites the right page.

---

Orki Docs MCP

Ask questions about Orki and get answers drawn from this documentation, with links back to the source pages.

• URL: https://orki.ai/docs-mcp
• Transport: Streamable HTTP
• No authentication

Tools: docs_search (find relevant pages) and docs_fetch (read one in full).

Orki App MCP

Manage your Orki account through AI chat. Tool groups cover agents, analytics, API tools, auth providers, billing, chats, customers, integrations, knowledge bases, marketing, products, system events, tags, tenant settings, and workflows.

• URL: https://app.orki.ai/services/mcp
• Transport: Streamable HTTP
• Requires authentication

Authentication

The App MCP uses OAuth. When you connect, your MCP client opens a browser window — sign in with your Orki account and the client handles the rest. The OAuth client ID is orki-mcp.

First steps with the App MCP

After connecting, ask the assistant to list your tenants, then select one. Tenant-scoped tools only appear once a tenant is selected.

---

Setup

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "orki-docs": {
      "type": "http",
      "url": "https://orki.ai/docs-mcp"
    },
    "orki-app": {
      "type": "http",
      "url": "https://app.orki.ai/services/mcp",
      "oauth": {
        "clientId": "orki-mcp"
      }
    }
  }
}

Cursor

.cursor/mcp.json in your project root — same block as above.

Windsurf

~/.codeium/windsurf/mcp_config.json — same block as above.

Claude Code (CLI)

claude mcp add --transport http orki-docs https://orki.ai/docs-mcp
claude mcp add --transport http orki-app  https://app.orki.ai/services/mcp

---

What to ask it

What you want	Server	Example prompt
Learn a feature	Docs	"How do I create a campaign?"
Find the right setting	Docs	"Where do I turn on personal data masking?"
Understand an integration	Docs	"What does the JOLT spec do in an API tool?"
Query your account	App	"Show me my VIP customers"
Take an action	App	"Send the Ramadan offer template to all gold-tier customers"
Check your usage	App	"How many conversations did we handle last week?"

tip

Start with the Docs MCP to learn Orki, then add the App MCP when you want your assistant to act on your workspace rather than just explain it.

---

Next Steps

• API Tokens — programmatic API access for your own integrations
• Webhooks — push events to your own systems