Claude & MCP integration

Connect Claude Desktop or Claude Code to your Jaina project via MCP.

What you'll need

  • A Jaina API token (/settings/tokensCreate token).
  • Claude Desktop or Claude Code installed.

Claude Desktop

Edit your Claude Desktop MCP config:

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

Add:

{
  "mcpServers": {
    "jaina": {
      "url": "https://jaina.dev/api/mcp",
      "auth": {
        "type": "bearer",
        "token": "jn_live_..."
      }
    }
  }
}

Restart Claude Desktop. The MCP tools appear in the bottom-left of the conversation UI.

Claude Code

Edit ~/.claude/settings.json:

{
  "mcp": {
    "servers": {
      "jaina": {
        "url": "https://jaina.dev/api/mcp",
        "auth": {
          "type": "bearer",
          "token": "jn_live_..."
        }
      }
    }
  }
}

Restart Claude Code (or /mcp restart).

Verify

In a Claude conversation, ask:

List my Jaina projects.

Claude calls jaina_list_projects and shows you the result.

What you can do

  • Read — list projects, schemas, packages, records; get individual records.
  • Write — create, update, delete records; create schemas; upload files.
  • Action — fire actions you've defined on schemas.
  • Reflect — list available MCP tools, get schema field definitions.

See the full tool reference.

Security

  • Tokens are scoped to your user — Claude can only see and modify your projects.
  • Row Level Security is enforced at the database level. No cross-user access is possible.
  • Revoke a token at /settings/tokens if you suspect it has leaked.