Claude Desktop

This documentation contains examples and quick tips for configuring the mcp.openapi.com server within Claude Desktop.

Official websites and documentation

At these addresses you can find the official and detailed documentation that we recommend consulting.

Configuration

1. Copy the sample file claude_desktop_config.json into the correct directory based on your system:

2. Edit the file claude_desktop_config.json and replace {OPENAPI_TOKEN} with a token generated via openapi.com:

 {
   "mcpServers": {
     "openapi.com": {
       "command": "npx",
       "args": [
         "mcp-remote",
         "https://mcp.openapi.com/",
         "--header",
         "Authorization: Bearer {OPENAPI_TOKEN}"
       ]
     }
   }
 }

3. Save the file and launch Claude Desktop to verify that it is configured correctly

Usage example

Check connection to the MCP server

Once Claude Desktop is started:

If we correctly see the list of tools, we are ready to get started!

Let’s try the service

If the token entered is valid, we can start “talking” naturally with the integrated services of openapi.com through the selected language model. In this demo, "Claud Sonnet 4" is selected. Please refer to the client documentation for details about available models, their costs, and availability.

Let’s ask a simple question to the model: I have 12 euros in my pocket, how much are they worth in dollars today?

Authorization is requested to execute the call to the specific MCP tool of mcp.openapi.com (in this case "get_today_exchange_rates"), which can be one-time or permanent:

By authorizing the client, you will immediately get the response:

Something more complex

How many joint-stock companies are there with a turnover above 10 million in the province of Terni?

In this example, the dryRun property of the company.openapi.com API was automatically set, allowing you to get a free "count" and a "cost" estimate related to the criteria entered for a hypothetical dataset extraction.

Extract a dataset

"make me a report in HTML format of openapi spa"