Spoki MCP with VS Code and GitHub Copilot

Connect Spoki to VS Code and GitHub Copilot Chat (Agent mode). Prefer Spoki login when VS Code offers Auth; use an API key only if login is not available.

Server URL:

https://mcp.spoki.com/v2/mcp

← Get Started with Spoki MCP · Authentication and URL

Option A: Spoki login (recommended) #

1. Install VS Code 1.99+ and GitHub Copilot Chat. Sign in to Copilot. On Business/Enterprise, ask an admin to enable MCP servers in Copilot.
2. Run MCP: Open User Configuration from the Command Palette (Ctrl+Shift+P / Cmd+Shift+P), or create .vscode/mcp.json.
3. Add the server block below. Replace YOUR_SPOKI_OAUTH_CLIENT_ID with the VS Code client ID from Spoki (Integrations / support). Do not put secrets in the file.
4. Save. Use Auth / Start above the server when VS Code shows it.
5. Complete Spoki login in the browser, pick the account, click Allow.
6. Open Copilot Chat → Agent, confirm Spoki tools, then ask: “What tags do I have in Spoki?”

{
  "servers": {
    "spoki": {
      "type": "http",
      "url": "https://mcp.spoki.com/v2/mcp",
      "oauth": {
        "clientId": "YOUR_SPOKI_OAUTH_CLIENT_ID"
      }
    }
  }
}

If Auth fails with a registration or redirect error, ask support@spoki.com for a VS Code client, or use Option B.

Option B: API key #

1. Create a key in Spoki: Integrations → Spoki MCP → Request Api Key.
2. Paste this into mcp.json, save, start spoki, and enter the key when prompted (VS Code stores it; do not commit keys).
3. In Copilot Chat Agent mode, confirm tools, then ask: “What tags do I have in Spoki?”

{
  "inputs": [
    {
      "type": "promptString",
      "id": "spoki-api-key",
      "description": "Spoki MCP API key",
      "password": true
    }
  ],
  "servers": {
    "spoki": {
      "type": "http",
      "url": "https://mcp.spoki.com/v2/mcp",
      "headers": {
        "X-Spoki-Api-Key": "${input:spoki-api-key}"
      }
    }
  }
}

You’re done when… #

• Spoki tools appear in Copilot Chat Agent mode.
• A new Agent chat can answer a simple Spoki question.

Common problems #

• Tools missing: Finish Allow (or enter a valid key), Start the server again, open a new Agent chat.
• Org blocks MCP: Copilot Business/Enterprise admins must enable MCP servers in Copilot.
• Wrong account or bad URL: Clear auth and sign in again; always use https://mcp.spoki.com/v2/mcp.

Need help? support@spoki.com.