Connecting Claude

Prerequisites

• A Jaina API token. Get one at /settings/tokens → Create token.
• Claude Desktop or Claude Code installed.

MCP on the Free plan is full read + write. Free identities can call read tools (browse, export, code generation) — including the jaina_list_projects and jaina_list_schemas calls in the First test below — and write tools (create / update / delete / upload). Free is bounded by volume (100 requests/hour and the Free quotas); Pro ($9.99/mo) and Enterprise raise those limits and add actions and webhooks.

The remote endpoint is https://jaina.dev/api/mcp, authenticated with a Bearer token in the Authorization header.

Claude Desktop

Edit your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add:

{
  "mcpServers": {
    "jaina": {
      "type": "http",
      "url": "https://jaina.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer jn_live_..."
      }
    }
  }
}

Restart Claude Desktop. A "Jaina" entry appears in the MCP tools panel.

Claude Code

Add the server with the CLI (this writes to ~/.claude.json):

claude mcp add --transport http jaina https://jaina.dev/api/mcp \
  --header "Authorization: Bearer jn_live_..."

Restart Claude Code (or run /mcp to confirm the jaina server is connected).

First test

In a Claude conversation:

List my Jaina projects.

Claude calls jaina_list_projects and prints the result.

Show me the schemas in my-game.

Claude calls jaina_list_schemas with project_slug: "my-game".

Token rotation

Best practice: rotate tokens quarterly. To rotate:

1. Generate a new token at /settings/tokens.
2. Update your config file.
3. Restart Claude.
4. Revoke the old token.

Troubleshooting

The Jaina entry doesn't appear. Verify the JSON is valid. Look for syntax errors. Restart Claude completely (not just reload).

Tools are listed but calls fail with 401. The token is invalid or revoked. Generate a new one.

Calls hang. Network issue between your machine and jaina.dev. Check curl https://jaina.dev/api/v1/projects -H "Authorization: Bearer jn_live_..." from the same machine.

Tools work but Claude doesn't use them. Be explicit: "Use the jaina MCP tools to list my projects."