---
title: "Claude Code"
description: "Add Gessa to `~/.claude/mcp.json`."
engineVersion: v1.0.234
date: 2026-09-28
license: "(c) Gessa, proprietary. Cite with attribution to https://gessa.ai/docs/. Terms: https://gessa.ai/terms/."
canonical: https://gessa.ai/docs/creator/mcp/claude-code/
---
# Claude Code

Add Gessa to `~/.claude/mcp.json`.

```json
{
  "mcpServers": {
    "gessa": {
      "command": "npx",
      "args": ["-y", "@gessa/mcp-server"],
      "env": {
        "GESSA_API_KEY": "mcpkey_xxx",
        "GESSA_API_URL": "https://api.gessa.ai"
      }
    }
  }
}
```

Verification: Run Claude Code and ask it to call `workspace_list`.

Common failures are a missing `GESSA_API_KEY`, an API URL without `https://`, or a revoked key.