Setup Guide
Detailed instructions for connecting Gilito to every supported AI client.
Prerequisites
- A Gilito account — sign up here
- An API key (
glt_*) — get one here - 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:
- Go to claude.ai → Settings → Connectors
- Click "Add custom connector"
- Enter the MCP server URL:
https://mcp.gilito.ai/mcpYou'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
| Variable | Required | Default | Description |
|---|---|---|---|
GILITO_API_KEY | STDIO only | - | Your Gilito API key |
GILITO_API_URL | No | https://api.gilito.ai | Backend API URL (for self-hosting) |
PORT | No | 3100 | HTTP server port (remote mode only) |
Rate Limits
| Plan | Requests per Minute |
|---|---|
| Free | 30 |
| Pro | 150 |
| Advanced | 500 |
| Enterprise | 2,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.