# Integrate a remote MCP server with an MCP Client
---

[MCP](https://modelcontextprotocol.io/introduction) is an open protocol that standardizes how applications provide context to AI models​. The [Infobip MCP server](https://www.infobip.com/mcp/) 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](https://www.cursor.com/en) or [Claude desktop](https://claude.ai/download) to use it with Infobip APIs.

## Prerequisites [#prerequisites]

- Node.js v 18 upwards.
- [Infobip account](https://portal.infobip.com/login/?callback=https%3A%2F%2Fportal.infobip.com%2F). If you do not have one create a [free trial account](https://www.infobip.com/signup).
- 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).__

1. Open __Cursor__ and navigate to __Cursor Settings__.
2. On the left-hand side, click __MCP__.
3. Click the __+Add new global MCP server__ button.
4. Populate the `mcp.json` connection to a remote MCP server with the Infobip MCP server settings (see section below).
5. Make sure that MCP server is enabled and you see list of tools
6. Use Chat to initiate Infobip APIs.

## Claude Desktop MCP Integration [#claude-desktop-mcp-integration-steps]

1. Open __Claude Desktop__ and navigate to __Settings__.
2. 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.
3. Access the `claude_desktop_config.json` file and populate with the connection settings to the Infobip MCP server (see section below).
4. Restart __Claude desktop__.
5. 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:

1. 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](https://www.infobip.com/mcp/).

    **Integration example with an API key**

    Key points:
    - You can access and edit your API key from your [Infobip account](https://portal.infobip.com/dev/api-keys).
    - 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](https://www.infobip.com/docs/essentials/api-essentials/api-authorization).

    ```json
    {
      "mcpServers": {
        "ib-viber": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.infobip.com/viber",
            "--header",
            "Authorization: App ${INFOBIP_API_KEY}"
          ],
          "env": {
            "INFOBIP_API_KEY": "<your api here infobip key>"
          }
        }
      }
    }
    ```

    **Integration example with OAuth**

    Key points:
    - Your MCP client must support OAuth 2.1 authentication and dynamic OAuth authorization server [metadata discovery](https://modelcontextprotocol.io/specification/2025-06-18/basic/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```

    ```json
    {
      "mcpServers": {
        "infobip-sms": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.infobip.com/sms"
          ]
        }
      }
    }
    ```

    ```json
    {
      "mcpServers": {
        "infobip-sms": {
          "command": "npx",
          "args": [
            "mcp-remote",
            "https://mcp.infobip.com/sms",
            "--debug",
            "--static-oauth-client-metadata",
            "{\"scope\":\"sms:manage profile\"}"
          ]
        }
      }
    }
    ```

2. Restart your MCP client.

## Additional resources [#additional-resources]

- Infobip MCP docs
- [Infobip MCP GitHub repo](https://github.com/infobip/mcp)
- [mcp-remote docs](https://github.com/geelen/mcp)