How to Turn Any OpenAPI Specification into an MCP Tool for Claude Desktop (In 60 Seconds)

#ai #claude #mcp #webdev

The Model Context Protocol (MCP) has made it possible to connect Large Language Models directly to external environments. But if your team already has a REST API documented in OpenAPI v3 / Swagger, writing a custom FastMCP server just to test it in Claude Desktop feels like unnecessary boilerplate.

In this guide, we'll look at how to convert any standard OpenAPI definition into a fully functional Claude Desktop tool in under 60 seconds without running a backend server.

The Architecture Problem

OpenAPI describes HTTP endpoints, path parameters, and request bodies. Claude Desktop, on the other hand, speaks JSON-RPC 2.0 over standard input/output (stdio).

To bridge the two, you traditionally had to:

Write a Python or TypeScript wrapper using the MCP SDK.
Manually map each OpenAPI operationId to an MCP tool declaration.
Define JSON Schema objects for each argument.
Manage child process execution in claude_desktop_config.json.

Converting In-Browser with MCP Bridge

Instead of writing this code manually, you can use the open-source client parser at MCP Bridge.

Because the converter runs 100% in your browser using client-side JavaScript and WebAssembly, your API tokens and internal schemas never leave your computer.

Step 1: Export your OpenAPI Spec

Grab your raw OpenAPI JSON or YAML URL (e.g. from Swagger UI, FastAPI, or Postman).

Step 2: Generate the Config

Paste the URL into mcpbridge.org/convert and select Claude Desktop as your target client.

Step 3: Add to Claude Desktop

Open your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the generated snippet:

{
  "mcpServers": {
    "my-custom-api": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-openapi",
        "https://api.example.com/openapi.json"
      ],
      "env": {
        "API_KEY": "YOUR_SECRET_TOKEN_HERE"
      }
    }
  }
}

Restart Claude Desktop, and your API tools will appear under the hammer icon!

For a directory of hand-verified native MCP servers and configuration guides, check out MCP Bridge.

DEV Community