Integration Guides

Step-by-step setup instructions for every supported AI environment.

Claude Code (VS Code Extension)

Claude Code is Anthropic's official VS Code extension with native MCP support.

Project-level configuration (recommended)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Global configuration

Create or edit ~/.claude/.mcp.json to make Glippy available in all projects:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Verify

/mcp

You should see glippy-geo listed with 9 tools.

Claude CLI (Terminal)

The Claude CLI (claude) supports MCP servers for terminal-based AI assistance.

Configuration

Create .mcp.json in your working directory or globally at ~/.claude/.mcp.json:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Usage

claude

Then interact naturally:

> Analyse example.com for AI readiness

> Which AI crawlers does example.com block?

Non-interactive mode

claude -p "Analyse the GEO score of example.com and return the overall score"

Claude Desktop App

Claude Desktop is Anthropic's standalone desktop application with full MCP support.

macOS

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Windows

Edit %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Linux

Edit ~/.config/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Verify

Look for the MCP tools icon (hammer/wrench) in the Claude Desktop interface. Click it to see available Glippy tools.

Cursor IDE

Cursor is an AI-powered code editor with MCP support.

Configuration

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

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Global configuration

1. Open Cursor Settings (Cmd/Ctrl + ,)
2. Search for "MCP"
3. Add server configuration

Usage

In Cursor's AI chat panel:

Analyse my site example.com for AI readiness

Check if example.com has an llms.txt file

Windsurf IDE

Windsurf (by Codeium) supports MCP servers for enhanced AI capabilities.

Configuration

Create .windsurf/mcp.json in your project:

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  }
}

Usage

Use Windsurf's Cascade AI chat:

Run a GEO analysis on example.com

Generate a markdown report for our website

Continue.dev

Continue is an open-source AI code assistant that supports MCP.

Configuration

Edit ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "glippy-geo",
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "GLMCP-XXXX-XXXX-XXXX"
      }
    }
  ]
}

ChatGPT & OpenAI

ChatGPT and OpenAI APIs do not natively support MCP.

Current Workarounds

Until the official app launches, here are alternative approaches:

MCP-to-OpenAI Bridge

Use a bridge that exposes MCP tools as OpenAI function calls:

npx mcp-openai-bridge --server "npx -y glippy-mcp"

Direct Integration

Call the analysis engine directly in your code:

const { checkGEO } = require('glippy-mcp/src/geo-checker.js');

async function analyseWithOpenAI() {
  // Run GEO analysis
  const result = await checkGEO('example.com', { maxPages: 1 });

  // Pass result to OpenAI API
  const response = await openai.chat.completions.create({
    model: 'gpt-4',
    messages: [
      {
        role: 'system',
        content: 'You are a GEO analysis expert.'
      },
      {
        role: 'user',
        content: JSON.stringify(result, null, 2)
      }
    ]
  });

  return response.choices[0].message.content;
}

Other MCP Clients

The Glippy MCP server works with any MCP-compatible client.

Generic Configuration

{
  "mcpServers": {
    "glippy-geo": {
      "command": "npx",
      "args": ["-y", "glippy-mcp"],
      "env": {
        "GLIPPY_LICENSE_KEY": "YOUR_LICENSE_KEY"
      }
    }
  }
}

Running with Node.js directly

export GLIPPY_LICENSE_KEY="GLMCP-XXXX-XXXX-XXXX"
npx glippy-mcp

Docker

FROM node:18-alpine

ENV GLIPPY_LICENSE_KEY=GLMCP-XXXX-XXXX-XXXX

RUN npm install -g glippy-mcp

CMD ["glippy-mcp"]

Programmatic MCP Client

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
import { spawn } from 'child_process';

async function runAnalysis() {
  const serverProcess = spawn('npx', ['-y', 'glippy-mcp'], {
    env: {
      ...process.env,
      GLIPPY_LICENSE_KEY: 'GLMCP-XXXX-XXXX-XXXX'
    },
    stdio: ['pipe', 'pipe', 'inherit']
  });

  const transport = new StdioClientTransport({
    reader: serverProcess.stdout,
    writer: serverProcess.stdin
  });

  const client = new Client({
    name: 'my-app',
    version: '1.0.0'
  });

  await client.connect(transport);

  const result = await client.callTool({
    name: 'analyze_domain',
    arguments: { domain: 'example.com' }
  });

  console.log('Analysis result:', result);

  await client.close();
  serverProcess.kill();
}

Verification & Testing

Check server status

All Claude environments support viewing MCP server status:

/mcp

Test tool availability

Ask your AI assistant:

What Glippy GEO tools do you have access to?

Expected response should list all 9 tools.

Quick function test

Check if example.com has an llms.txt file

Troubleshooting

Debug mode

Run the server manually and watch stderr:

export GLIPPY_LICENSE_KEY="GLMCP-XXXX-XXXX-XXXX"
node /path/to/glippy-mcp/src/index.js 2>&1