Skip to main content

Other MCP Client Integrations

PDF Gen Studio MCP server works with various AI tools and editors that support the Model Context Protocol.

Windsurf (Codeium)​

Windsurf supports MCP through its configuration.

Configuration File Location​

macOS: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Linux: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Zed Editor​

Zed has native MCP support.

Configuration​

Edit ~/.config/zed/settings.json:

{
  "language_models": {
    "mcp_servers": {
      "pdfgenstudio": {
        "command": "npx",
        "args": ["-y", "@pdfgenstudio/mcp"],
        "env": {
          "PDFGENSTUDIO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Continue (VS Code/JetBrains Extension)​

Continue supports MCP servers for enhanced AI capabilities.

Configuration​

Edit ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "pdfgenstudio",
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  ]
}

HTTP/SSE Mode (For Custom Clients)​

For clients that support HTTP-based MCP connections:

Start the Server​

# Start HTTP server
npx @pdfgenstudio/mcp --transport http --port 3100

Available Endpoints​

EndpointDescription
http://localhost:3100/mcpHTTP Streaming
http://localhost:3100/sseServer-Sent Events
http://localhost:3100/healthHealth Check

Example Client Connection​

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("http://localhost:3100/mcp")
);

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

await client.connect(transport);

Troubleshooting​

Common Issues​

  1. "API key not configured"

    • Ensure PDFGENSTUDIO_API_KEY is set in the env section
    • Check for typos in the environment variable name

  2. "Command not found" (npx)

    • Make sure Node.js 18+ is installed
    • Try using the full path to npx: /usr/local/bin/npx

  3. Server not connecting

    • Restart your IDE/application after configuration changes
    • Check the logs for error messages
    • Verify the path is correct for local installations

  4. Windows path issues

    • Use forward slashes / or escaped backslashes \\ in paths
    • Use absolute paths

Debug Mode​

Run with debug logging:

DEBUG=* npx @pdfgenstudio/mcp

Verify Installation​

# Test the server directly
npx @pdfgenstudio/mcp --help

# Test with MCP Inspector
npx fastmcp inspect /path/to/pdfgenstudio-mcp/src/index.ts
Last updated on