Integrate a remote MCP server with an MCP Client

View as Markdown

MCP is an open protocol that standardizes how applications provide context to AI models. The Infobip MCP server allows LLMs to use Infobip CPaaS Platform tools.

This tutorial will show you how to integrate an Infobip MCP server with an MCP Client, like Cursor or Claude Desktop to use it with Infobip APIs.

Prerequisites [#prerequisites]

Node.js v 18 upwards.
Infobip account. If you do not have one create a free trial account.
An MCP Client, e.g. Cursor or Claude Desktop.

Cursor MCP Integration [#cursor-mcp-integration-steps]

Skip this section if integrating with Claude Desktop (see the section below).

Open Cursor and navigate to Cursor Settings.
On the left-hand side, click MCP.
Click the +Add new global MCP server button.
Populate the mcp.json connection to a remote MCP server with the Infobip MCP server settings (see section below).
Make sure that MCP server is enabled and you see list of tools
Use Chat to initiate Infobip APIs.

Claude Desktop MCP Integration using the Connectors UI and OAuth [#claude-desktop-mcp-integration-connectorsUi]

You need to be an administrator of the account. Only the OAuth authentication method is supported.

Open Claude Desktop and click the '+' button on the bottom of the chat box, then select Connectors.
Click Add custom connector and add a remote MCP server URL, e.g. https://mcp.infobip.com/viber. The connector will be added but not connected yet.
Click Connect to connect the server. This will take you to the browser version of Claude where you'd need to be logged in to proceed.
Once logged in, click Connect again and you'll see the Infobip login screen. Once you log into your account, the MCP server will be successfully connected to your Claude Desktop instance.

Claude Desktop MCP Integration using the JSON config file [#claude-desktop-mcp-integration-JSON-config]

This method support any account type and authentication method.

Open Claude Desktop and navigate to Settings.
Use the Developer tab to click the Edit config button. This will show you the location of the claude_desktop_config.json file in your file system. You'll use the file to add the Infobip MCP server settings.
Access the claude_desktop_config.json file and populate with the connection settings to the Infobip MCP server (see section below).
Restart Claude Desktop.
Use Chat to initiate Infobip APIs.

Infobip MCP Server settings [#infobip-mcp-server-settings]

Each Infobip API endpoint is served as a separate MCP server to narrow down the context for the AI agent in use. As such, you need to add each endpoint aka server separately.

To configure an MCP server:

Choose an authentication method, API Key or OAuth and which server you want to connect to. For the list of all supported MCP endpoints, check out the Infobip MCP documentation.

Integration example with an API key

Key points:
- You can access and edit your API key from your Infobip account.
- Your API key must include the correct scope depending on the MCP server you want to integrate. For example, if you want to use the SMS MCP server, your API Key needs the sms:message:send scope. Find out more about scopes in API Authorization.
json
1{
2 "mcpServers": {
3 "ib-viber": {
4 "command": "npx",
5 "args": [
6 "https://mcp.infobip.com/viber",
7 "--header",
8 "Authorization: App ${INFOBIP_API_KEY}"
9 ],
10 "env": {
11 "INFOBIP_API_KEY": "<Your Infobip API Key here>"
12 }
13 }
14 }
15}

Integration example with OAuth

Key points:
- Your MCP client must support OAuth 2.1 authentication and dynamic OAuth authorization server metadata discovery.
- For MCP clients that don't support automatic scopes_supported discovery, you must manually configure scopes available to view: {mcp-server-url}/.well-known/oauth-authorization-server
REQUEST SAMPLES
json
1{
2 "mcpServers": {
3 "infobip-sms": {
4 "command": "npx",
5 "args": [
6 "https://mcp.infobip.com/sms"
7 ]
8 }
9 }
10}
Restart your MCP client.

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.

json

2 "mcpServers": {

3 "infobip-viber": {

4 "command": "cmd",

5 "args": [

6 "/c",

7 "npx",

8 "mcp-remote",

9 "https://mcp.infobip.com/viber",

10 "--header",

11 "Authorization: App YOUR_API_KEY_HERE"

12 ]

13 }

14 }

15}