Guides

Connecting the Intely MCP Server

The Intely MCP server lets an AI assistant work directly against your Intely organization:
list and inspect integrations, mappings, data types, app instances and agents, run them, and read
execution results, without leaving the assistant.

It is a remote MCP server. Nothing is installed on your machine beyond your assistant's own
configuration, and there is no token to copy: the first time a client connects it opens your
browser, you sign in with your normal Intely credentials, and the client keeps its own access
current from then on.

Find it under Organization → MCP. That page shows the URL for your organization already
filled in, with a copy button next to every command and config block below.

Your MCP server URL

Every client needs one value, the server URL for your organization:

https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]

Replace [YOUR_ORGANIZATION_ID] with your organization's ID. You can find it under
Organization → Information, or copy the complete URL from Organization → MCP.

If you belong to more than one organization, add one server entry per organization to your
client, each with that organization's URL. The organizationId in the URL decides which
organization the assistant works in.

The examples below register the server under the name intely. Any name works; keep it the same
across a client's commands and config.

Claude Code

  1. Add the server for every project. Drop --scope user to limit it to the current project. Keep
    the quotes around the URL, or zsh (the macOS default shell) stops with "no matches found". 
    claude mcp add --transport http --scope user intely "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
  2. Start a session, run /mcp, select intely and choose Authenticate.
  3. Sign in with your Intely credentials in the browser that opens.

Claude Desktop

  1. Open Customize → Connectors and choose Add custom connector.
  2. Enter Intely as the name and paste the server URL, then click Add.
  3. Click Connect on the new connector and sign in with your Intely credentials in the browser
    that opens.

ChatGPT

The Plugins page is the same on the web and in the desktop app.

  1. Open Plugins, click Add and choose Add Custom MCP Server.
  2. Enter intely as the name, paste the server URL and set Authentication to OAuth.
  3. Click Connect and sign in with your Intely credentials in the browser that opens.

ChatGPT Codex

  1. Add the server with the Codex CLI. Keep the quotes around the URL, or zsh (the macOS default
    shell) stops with "no matches found". 
    codex mcp add intely --url "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
    Or add it by hand to ~/.codex/config.toml: 
    [mcp_servers.intely]
url = "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
  2. Log in to the server: 
    codex mcp login intely
  3. Sign in with your Intely credentials in the browser that opens.

Antigravity (macOS / Linux)

Antigravity cannot sign in to remote MCP servers yet, so connect through mcp-remote, a small
bridge that runs on your machine and handles the browser sign-in. These steps apply to both the
Antigravity app and the agy CLI, and require Node.js. The app and the CLI share one config file,
so you only add the server once.

  1. Find the full path to npx. Antigravity does not load your shell profile, so it cannot find
    npx by name if Node.js was installed with nvm or Homebrew. 
    which npx
  2. Open the MCP config file. In the app open Settings → Customizations → Installed MCP Servers
    and click Open MCP Config. With the agy CLI, open ~/.gemini/config/mcp_config.json
    (older installs use ~/.gemini/antigravity/mcp_config.json) in a text editor and create it if
    it does not exist yet.
  3. Add the server to the config and save the file. Replace <path to npx> with the output of the
    first step, and <npx folder> with that path without the trailing /npx. 
    {
  "mcpServers": {
    "intely": {
      "command": "<path to npx>",
      "args": [
        "-y",
        "[email protected]",
        "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]",
        "--static-oauth-client-metadata",
        "{\"client_uri\":\"http://localhost\"}"
      ],
      "env": {
        "PATH": "<npx folder>:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}
  4. In the app, refresh the server list. In the CLI, start a session with agy and run /mcp to
    check that the server is listed.
  5. Sign in with your Intely credentials in the browser that opens. mcp-remote stores and
    refreshes your access from then on.

Antigravity (Windows)

The same mcp-remote bridge as on macOS and Linux; the steps apply to the Antigravity app and the
agy CLI and require Node.js.

  1. Check that npx is on your PATH by running this in a new Command Prompt. It should print a path
    such as C:\Program Files\nodejs\npx.cmd. If it prints nothing, install Node.js from
    nodejs.org and open a new Command Prompt. 
    where npx
  2. Open the MCP config file. In the app open Settings → Customizations → Installed MCP Servers
    and click Open MCP Config. With the agy CLI, open
    %USERPROFILE%\.gemini\config\mcp_config.json in a text editor and create it if it does not
    exist yet.
  3. Add the server to the config and save the file. On Windows npx is a script, so it is started
    through cmd. 
    {
  "mcpServers": {
    "intely": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "[email protected]",
        "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]",
        "--static-oauth-client-metadata",
        "{\"client_uri\":\"http://localhost\"}"
      ]
    }
  }
}
  4. In the app, refresh the server list. In the CLI, start a session with agy and run /mcp to
    check that the server is listed.
  5. Sign in with your Intely credentials in the browser that opens. mcp-remote stores and
    refreshes your access from then on.

Cursor

  1. Open the Customize tab, select MCPs and click New MCP Server, or create
    .cursor/mcp.json in your project for a project-only server.
  2. Add the server to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project) and save the
    file: 
    {
  "mcpServers": {
    "intely": {
      "url": "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
    }
  }
}
  3. Back in Customize → MCPs, click Authenticate next to intely and sign in with your
    Intely credentials.

Cursor CLI

The CLI shares its MCP config file with the Cursor editor.

  1. Open the Cursor MCP config file in a text editor, and create it if it does not exist yet. Use
    ~/.cursor/mcp.json to make the server available in every project, or .cursor/mcp.json
    inside a project to limit it to that project. If you already added the server in the Cursor
    editor (Customize → MCPs), it is already in this file: skip to the login step below.

  2. Add the server to the config and save the file. If the file already lists other servers, add the
    intely entry inside the existing mcpServers object.

    {
  "mcpServers": {
    "intely": {
      "url": "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
    }
  }
}

  3. Start a session with agent, run /mcp list, select intely, choose Manage Server and
    then Login.

    Or log in from the terminal. Cursor saves the login per project folder, so you may have to log
    in once more when you open another repository.

    cursor-agent mcp login intely

  4. Sign in with your Intely credentials in the browser that opens.

Grok Build

  1. Start a session, run /mcps and press a to add a server.

  2. Paste the server URL and enter intely as the name.

    Or add it from the terminal, then run /mcps in a session. Keep the quotes around the URL, or
    zsh (the macOS default shell) stops with "no matches found".

    grok mcp add --transport http intely "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"

  3. Highlight intely in the list and press i to authenticate, then sign in with your Intely
    credentials in the browser that opens.

Copilot CLI

  1. Start copilot and run /mcp add. Enter intely as the server name, choose HTTP as the
    type and paste the server URL.

    Or add it by hand to ~/.copilot/mcp-config.json and restart the CLI:

    {
  "mcpServers": {
    "intely": {
      "type": "http",
      "url": "https://mcp.intely.io/mcp?organizationId=[YOUR_ORGANIZATION_ID]"
    }
  }
}

  2. Sign in with your Intely credentials when the CLI prompts you to authenticate.

GitHub Copilot

VS Code checks the server URL against the server's own metadata exactly, so use the plain URL and
name the organization in the current-organization-id header instead of the URL. With
?organizationId= in the URL, VS Code fails to connect and asks for a client ID.

  1. Add the server to the workspace MCP config file .vscode/mcp.json, or to your user profile's
    file (Command Palette → MCP: Open User Configuration): 
    {
  "servers": {
    "intely": {
      "type": "http",
      "url": "https://mcp.intely.io/mcp",
      "headers": {
        "current-organization-id": "[YOUR_ORGANIZATION_ID]"
      }
    }
  }
}
  2. Start the server from the MCP Servers view, or from the Start link shown above it in the
    config file, and sign in with your Intely credentials when prompted.

Verifying it works

Ask the assistant to list your organization's integrations. A successful call returns records
from your organization. If the client reports it is not authenticated, run its authenticate or
login action again.

What the assistant can do

Every call runs as you: the assistant can only see and change what your Intely user is
allowed to, and platform audit records attribute the work to you. Tools are grouped by domain
(integrations, mappings, data types, crosswalks, apps, app instances, projects, files, agents,
Interface Server) and the client is granted only the scopes it asks for, so a read-only
connection cannot make changes.

Updated 5 days ago

Did this page help you?