Skip to main content

​
Quick Setup

1

Get your API key

Go to Settings → API Keys → Generate New Key in your Cortana AI dashboard. Enable all read scopes.
2

Copy your Business ID

Find it in your browser URL: app.usecortana.ai/business/your-id-here/...
3

Add the MCP server

Pick your AI tool below and paste the configuration.

​
Claude.ai (Remote Connector)

The fastest way — no installation needed. Works directly in your browser at claude.ai.
  1. Go to Claude.ai → Settings → Connectors
  2. Click “Add custom connector”
  3. Enter name: Cortana AI
  4. Enter URL: https://app.usecortana.ai/api/mcp
  5. Click Advanced settings and add your API key as a Bearer token
  6. Click Add
Start chatting — Claude will discover all Cortana AI tools automatically.

​
Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config and add:
claude_desktop_config.json
{
  "mcpServers": {
    "cortana-ai": {
      "command": "npx",
      "args": ["-y", "@cortana-ai/mcp-server@latest"],
      "env": {
        "AGENTKONG_API_KEY": "sk-ak-your-api-key",
        "AGENTKONG_BUSINESS_ID": "your-business-id",
        "AGENTKONG_API_URL": "https://app.usecortana.ai"
      }
    }
  }
}
Restart Claude Desktop. You’ll see a hammer icon in the chat input — your tools are loaded.

​
Claude Code

claude mcp add cortana-ai -- npx -y @cortana-ai/mcp-server@latest
Then set environment variables: 
export AGENTKONG_API_KEY="sk-ak-your-api-key"
export AGENTKONG_BUSINESS_ID="your-business-id"
export AGENTKONG_API_URL="https://app.usecortana.ai"

​
Cursor

Open Cursor → Settings → MCP Servers or edit ~/.cursor/mcp.json:
~/.cursor/mcp.json
{
  "mcpServers": {
    "cortana-ai": {
      "command": "npx",
      "args": ["-y", "@cortana-ai/mcp-server@latest"],
      "env": {
        "AGENTKONG_API_KEY": "sk-ak-your-api-key",
        "AGENTKONG_BUSINESS_ID": "your-business-id",
        "AGENTKONG_API_URL": "https://app.usecortana.ai"
      }
    }
  }
}

​
VS Code

Add to .vscode/mcp.json in any workspace:
.vscode/mcp.json
{
  "servers": {
    "cortana-ai": {
      "command": "npx",
      "args": ["-y", "@cortana-ai/mcp-server@latest"],
      "env": {
        "AGENTKONG_API_KEY": "sk-ak-your-api-key",
        "AGENTKONG_BUSINESS_ID": "your-business-id",
        "AGENTKONG_API_URL": "https://app.usecortana.ai"
      }
    }
  }
}

​
Windsurf

Add to your Windsurf MCP config: 
{
  "mcpServers": {
    "cortana-ai": {
      "command": "npx",
      "args": ["-y", "@cortana-ai/mcp-server@latest"],
      "env": {
        "AGENTKONG_API_KEY": "sk-ak-your-api-key",
        "AGENTKONG_BUSINESS_ID": "your-business-id",
        "AGENTKONG_API_URL": "https://app.usecortana.ai"
      }
    }
  }
}

​
Configuration Reference

VariableRequiredDescription
AGENTKONG_API_KEYYesYour API key starting with sk-ak-
AGENTKONG_BUSINESS_IDYesBusiness UUID from your dashboard URL
AGENTKONG_API_URLNoAPI base URL. Defaults to https://app.usecortana.ai

​
npm Package

@cortana-ai/mcp-server

View on npm