Connect your AI app

Add the URL below to your AI app. It opens a browser, walks you through sign-in, and lets you pick exactly what your assistant can access. You'll need a VoIP.ms account with API access turned on — see the prerequisites below.

Your MCP server URL

https://voipms-mcp.ecliptical.io/mcp

What to expect on first connect

1

Sign in

Your AI app opens a browser to sign in. New here? You'll create an account in the same step.

2

Choose access

Review what the app is asking for and approve any subset — read-only or full, resource by resource.

3

Connect your account

Save your VoIP.ms API credentials once in the dashboard; they stay on the server and are never shared with the AI app.

Before you connect

This server acts on your own VoIP.ms account, so you need two things in place first. Both are set in the VoIP.ms API settings.

  • A VoIP.ms account with API access enabled. Under API → Enable/Disable API, turn the API on and set an API password. That username and password are the credentials you save in the dashboard — not your portal login.
  • Source-IP access for the server. Under API → Allowed IP Addresses, add voipms-proxy.ecliptical.io so the server can reach the API on your behalf. Keep any entries already there — this only adds ours.

See the full scope catalog for everything you can grant.

App setup

Pick your app. Each uses the same server URL above — substitute your own if you are reading this off a different deployment.

Claude Desktop

Claude Desktop connects to remote MCP servers as connectors.

  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Give it a name (e.g. VoIP.ms) and paste the server URL:
https://voipms-mcp.ecliptical.io/mcp
  1. Save, then click Connect — a browser opens to sign in and choose access.
  2. Once connected, the VoIP.ms tools appear in the connector list.
Claude Code

Add the server from the CLI as an HTTP transport:

claude mcp add --transport http voipms https://voipms-mcp.ecliptical.io/mcp
  1. Run /mcp inside Claude Code and authenticate when prompted — a browser opens for sign-in and to choose access.
  2. After approval the VoIP.ms tools are available in the session.
ChatGPT

ChatGPT reaches remote MCP servers through connectors (developer mode / connectors, where available on your plan).

  1. In Settings → Connectors, choose to add a custom / remote MCP server.
  2. Paste the server URL:
https://voipms-mcp.ecliptical.io/mcp
  1. Complete the sign-in and access prompts in the browser, then enable the connector in your chat.
Cursor

Add the server to Cursor's MCP config — ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "voipms": {
      "url": "https://voipms-mcp.ecliptical.io/mcp"
    }
  }
}
  1. Reload Cursor. Open Settings → MCP and sign in when prompted to authorize the connection.
Visual Studio Code

VS Code (Copilot agent mode) reads MCP servers from .vscode/mcp.json in your workspace:

{
  "servers": {
    "voipms": {
      "type": "http",
      "url": "https://voipms-mcp.ecliptical.io/mcp"
    }
  }
}
  1. Save the file, then click Start on the server in the editor and sign in when prompted.
  2. The VoIP.ms tools become available to Copilot in agent mode.
Any other MCP client

Any client that supports a remote MCP server over the streamable HTTP transport with OAuth can connect. Configure it with:

  • Transport: Streamable HTTP (POST). Server-Sent Events are not used.
  • URL: https://voipms-mcp.ecliptical.io/mcp
  • Auth: OAuth 2.1. The client discovers the authorization server automatically from the protected-resource metadata; no manual client registration is needed.