GorillaDesk MCP

Reference

Introduction

The GorillaDesk MCP lets AI coding tools access your GorillaDesk data. Connect Claude Code, Cursor, OpenCode, or any MCP-compatible tool to pull customer info, jobs, invoices, and more — right into your AI workflow.

Authentication

The GorillaDesk MCP uses Bearer token authentication. Provide your API key in the Authorization header.

API keys are per-company and can be generated from your GorillaDesk settings.

Include the following request header on every call:

Authorization: Bearer ACCESS_TOKEN

On each request, the server validates your key and signs a short-lived JWT for upstream GraphQL calls. You never need to manage JWTs yourself.

Setup Tutorial

Claude Code

Run in terminal:

claude mcp add gorilladesk --url http://<your-host>:3333 --header "Authorization: Bearer ACCESS_TOKEN"

Or add to .claude/settings.local.json:

{
  "mcpServers": {
    "gorilladesk": {
      "type": "http",
      "url": "http://<your-host>:3333",
      "headers": { "Authorization": "Bearer ACCESS_TOKEN" }
    }
  }
}

Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "gorilladesk": {
      "type": "http",
      "url": "http://<your-host>:3333",
      "headers": { "Authorization": "Bearer ACCESS_TOKEN" }
    }
  }
}

OpenCode

Add to opencode.json:

{
  "mcp": {
    "gorilladesk": {
      "type": "remote",
      "url": "http://<your-host>:3333",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    }
  }
}

VS Code (Cline)

Open Cline extension settings → MCP Servers → Edit cline_mcp_settings.json:

{
  "mcpServers": {
    "gorilladesk": {
      "type": "http",
      "url": "http://<your-host>:3333",
      "headers": { "Authorization": "Bearer ACCESS_TOKEN" }
    }
  }
}