Claude & MCP integration

What you'll need

• A Jaina API token (/settings/tokens → Create token).
• Claude Desktop or Claude Code installed.

MCP works on every plan, including Free — read and write. Connect Claude or Cursor on the Free plan and create schemas, add records, and run codegen, all via natural language. Free is bounded by volume, not access: 100 API requests/hour and the Free quotas (1 project, 10 schemas, 100 records/schema). Pro ($9.99/mo) and Enterprise raise those limits and add actions and webhooks.

The remote MCP endpoint is https://jaina.dev/api/mcp. Authentication is a Bearer token (your Jaina API token) sent in the Authorization header.

Fastest setup: jaina init

If you have the CLI, one command does the whole bootstrap. It authenticates you (opening the browser to create a token), creates a starter project, and writes the jaina MCP server entry into every AI client it detects (Claude Desktop, Claude Code, Cursor):

npx jaina-cli init

Flags: --token <key> to skip the browser, --project <name> to name the starter project, --client claude-code,cursor to target specific clients, --all to write all of them, --yes to skip the confirmation prompt. Re-running is safe: it merges into your existing config and leaves other MCP servers untouched.

Restart your AI client and you are connected. Prefer to wire it up by hand? The manual steps for each client are below.

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": {
      "type": "http",
      "url": "https://jaina.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer jn_live_..."
      }
    }
  }
}

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

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_..."

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

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 (all plans) — list projects, schemas, packages, records; get individual records; export.
• Write (all plans) — create, update, delete records; create schemas; upload files. Bounded by your plan's quotas (records/schema, storage) and rate limit.
• Action (Pro / Enterprise) — fire actions you've defined on schemas. The Free plan allows 0 actions per schema, so this is effectively a paid feature.
• Reflect (all plans) — list available MCP tools, get schema field definitions.
• Import code (all plans) — jaina_schema_from_code turns your existing TypeScript interfaces into matching Jaina schemas. Paste your types and ask Claude to "create Jaina schemas from this code."

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.