Integrate the Infobip MCP server with Claude Desktop
As an outcome of this guide, you will have Claude Desktop connected to an Infobip MCP server. This guide uses the Infobip SMS MCP server as an example.
This guide is specific to Claude Desktop. If you are using a different MCP client, see Integrate the Infobip MCP server with an MCP client.
For the full list of available MCP server, see MCP endpoints.
Prerequisites [#prerequisites]
-
Windows only: Node.js version 18 upwards, required for the Windows workaround configuration.
-
Claude Desktop installed on macOS or Windows.
-
Infobip account. If you do not have one, create a free trial account.
-
For API key authentication: an Infobip API key with the correct scope for the MCP server you want to use. You can manage your API keys from your Infobip account.
See API Authorization for more information.
Key points [#points]
- The Connectors UI only supports OAuth. For API key authentication, use the JSON config file method.
- Each Infobip API endpoint is a separate MCP server. Add each one individually.
Difficulty level [#difficulty-level]
Beginner. No coding experience necessary.
Summary of the steps [#steps-summary]
- Choose an integration method:
- Connectors UI: OAuth authentication.
- JSON config file: API key or OAuth, any account type.
- For OAuth, log into Infobip account. For API key, provide Claude Desktop config file with your API key.
- Restart Claude Desktop and send your first message.
Connectors UI [#connectors-ui]
You need to be an administrator of the account. Only the OAuth authentication method is supported.
- Open Claude Desktop and click the + button at the bottom of the chat box, then select Connectors.
- Click Add custom connector and enter the Infobip MCP server URL, for example
https://mcp.infobip.com/sms. The connector is added but not yet connected. - Click Connect. Claude Desktop opens a browser window where you need to be logged in to your Claude account to proceed.
- Once logged in, click Connect again. The Infobip login screen appears. Log in to your Infobip account. The MCP server is now connected.
JSON config file [#json-config]
This method supports any account type and authentication method.
Step 1. Open the config file [#step-1-open-config]
- Open Claude Desktop and navigate to Settings.
- Navigate to the Developer tab and click Edit Config. This opens
claude_desktop_config.jsonin your file system.
The file is located at:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Step 2. Add the Infobip MCP server [#step-2-add-server]
Add your chosen Infobip MCP server to the mcpServers object in the config file. For the full list of available endpoints, see the Infobip MCP documentation.
OAuth authentication
Claude Desktop triggers the OAuth authorization flow automatically on first connection.
API key authentication
Replace <YOUR_INFOBIP_API_KEY> with your Infobip API key and sms with your chosen MCP endpoint name. Your API key must include the correct scope. For example, to use the SMS MCP server your key needs the sms:message:send scope.
To learn more about scopes, see API Authorization.
For unexpected Windows issues, go to the Windows workarounds section.
Step 3. Restart Claude Desktop [#step-3-restart]
Save the config file, then fully quit and restart Claude Desktop. After restarting, an MCP indicator icon appears in the bottom-right corner of the chat input box, confirming the server connected successfully.
Click the indicator to view the list of available Infobip tools.
Verify the connection [#verify-connection]
After connecting, the MCP indicator icon appears in the chat input. Click it to confirm the Infobip tools are listed.
To test end-to-end, try a prompt such as: "Send an SMS to +447415774332 saying Hello from Infobip."
Windows workarounds [#windows-workarounds]
On Windows, Claude Desktop may have trouble finding and running the required tools. It's recommended to install Node.js using the official installer, as version managers often configure PATH in a way that graphical applications like Claude Desktop may have problems accessing.
To further help with the issue, the following code sample substitutes the npx command with cmd /c, which allows Windows to handle tool finding on its own.