Coding agent

How to make your favorite coding agent aware of Apizee APIs

Apizee’s developer documentation exposes a Model Context Protocol (MCP) server that allows AI-powered editors and coding agents to query documentation natively.

Your MCP server URL is:

https://developer.apizee.com/apizee-docs/~gitbook/mcp

When connected to your editor, your assistant (Claude, Copilot, Cursor Agent, Windsurf AI) can retrieve documentation, search pages, and use documentation-aware tools without scraping or copy/pasting.

This guide walks you through steps per tool.

Cursor

Steps

  1. Open Cursor.

  2. Go to Settings → MCP Servers.

  3. Choose Global or Workspace configuration.

  4. Click Add MCP Server.

  5. Configure:

    • Name: apizee-docs

    • Transport: http

    • URL:

      https://developer.apizee.com/apizee-docs/~gitbook/mcp
  6. Save.

Validation

Open the Cursor Agent and type:

“List MCP servers” or “Use the apizee-docs server to search for X”

Visual Studio Code (GitHub Copilot)

Steps

  1. Click on any page actions button (top right) in the Apizee documentation.

  2. Select the "Connect to VS Code" menu item

  3. Authorize to open Visual Studio Code from the browser.

  4. In Visual Studio Code, click on Install or Install in Workspace.

  5. Reload VS Code.

Validation

Command palette →

MCP: List Servers

You should see apizee-docs.

Claude Desktop (Claude Code)

Claude Desktop loads MCP configuration from a local config file.

Steps

  1. Close Claude Desktop completely.

  2. Open the config file:

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json
  1. Add the server:

{
  "mcpServers": {
    "apizee-docs": {
      "transport": "http",
      "url": "https://developer.apizee.com/apizee-docs/~gitbook/mcp"
    }
  }
}

If other servers already exist, merge entries appropriately.

  1. Save the file and restart Claude Desktop.

Validation

Ask Claude:

“Connect to the apizee-docs MCP server and list its tools.”

Windsurf (Codeium IDE)

Steps

  1. Open Windsurf.

  2. Open Command Palette:

    • macOS: Cmd + K

    • Windows/Linux: Ctrl + K

  3. Search for: “AI: Configure MCP Server”

  4. Click Add MCP Server.

  5. Fill in:

    • Name: apizee-docs

    • Transport: HTTP

    • URL:

      https://developer.apizee.com/apizee-docs/~gitbook/mcp
  6. Save the configuration.

  7. Restart Windsurf (important).

Validation

Open the AI assistant panel and type:

“Show my MCP servers.”

You should see apizee-docs.

Best Practices

  • Your Apizee Developer Docs MCP endpoint is public and requires no authentication, making integration straightforward.

  • If running behind a corporate firewall, ensure HTTPS access to:

    developer.apizee.com
  • If MCP tools do not appear, restart the IDE.

Last updated