Gilito AIDocs

Setup Guide

Detailed instructions for connecting Gilito to every supported AI client.

Prerequisites

  1. A Gilito account — sign up here
  2. An API key (glt_*) — get one here
  3. Node.js 22+ installed (for local STDIO mode)

Option 1: Claude Desktop

Edit your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gilito": {
      "command": "npx",
      "args": ["-y", "@gilito/mcp-server", "--stdio"],
      "env": {
        "GILITO_API_KEY": "glt_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You should see a hammer icon indicating MCP tools are available.

Option 2: Claude Code (CLI)

Add to ~/.claude/claude_desktop_config.json or your project's .mcp.json:

{
  "mcpServers": {
    "gilito": {
      "command": "npx",
      "args": ["-y", "@gilito/mcp-server", "--stdio"],
      "env": {
        "GILITO_API_KEY": "glt_your_api_key_here"
      }
    }
  }
}

Option 3: VS Code / Cursor

Create .vscode/mcp.json in your project root:

{
  "mcpServers": {
    "gilito": {
      "command": "npx",
      "args": ["-y", "@gilito/mcp-server", "--stdio"],
      "env": {
        "GILITO_API_KEY": "glt_your_api_key_here"
      }
    }
  }
}

Option 4: Claude.ai (Remote HTTP)

For browser-based Claude, use the remote MCP endpoint:

  1. Go to claude.ai → Settings → Connectors
  2. Click "Add custom connector"
  3. Enter the MCP server URL:
https://mcp.gilito.ai/mcp

You'll be prompted to enter your API key as a Bearer token.

Option 5: Global npm Install

For faster startup (no npx download each time):

npm install -g @gilito/mcp-server

# Then configure with:
# "command": "gilito-mcp"
# instead of "command": "npx"

Environment Variables

VariableRequiredDefaultDescription
GILITO_API_KEYSTDIO only-Your Gilito API key
GILITO_API_URLNohttps://api.gilito.aiBackend API URL (for self-hosting)
PORTNo3100HTTP server port (remote mode only)

Rate Limits

PlanRequests per Minute
Free30
Pro150
Advanced500
Enterprise2,000

Troubleshooting

Tools not appearing in Claude?

Make sure you restarted the app after editing the config file. Check that your API key is valid.

Getting "Unauthorized" errors?

Verify your API key is correct and hasn't expired. Generate a new one from your settings page.

Rate limit exceeded?

Wait for the reset window (1 minute) or upgrade your plan for higher limits.