Documentation

esc
    AI / Connect your AI

    Connect your AI app to Pantech

    Let Claude, ChatGPT, Cursor, VS Code and other AI apps look after your Pantech servers, with one link and your approval.

    Paste one link into your AI app, approve it in the console, and you can ask things like "what is running?" or "make me a small Ubuntu server".

    text
    https://mcp.pantechdynamics.com/mcp

    What MCP is

    MCP (the Model Context Protocol) is a standard way for an AI app to use outside tools. Pantech runs an MCP server at the link above. Your AI app connects to it, and it gets a set of Pantech tools: list machines, create a network, check your bill, and so on. Every tool calls the public API as you, with the access you approved. Nothing else is shared.

    How connecting works

    1. Add the link to your AI app (the steps for each app are below).
    2. The app opens your browser at the console's approval page. Sign in if you need to.
    3. Choose the organization, the access level and when it expires, then press Allow. Connecting an app needs two-factor authentication on your account.
    4. Go back to your AI app. It is connected.

    What the approval page asks

    • Organization. If you belong to more than one, pick the one this app may use. One connection works in one organization.
    • Access.
      • Read only: look at what the organization runs and what it costs, never change. Good for questions about cost and status.
      • Manage (the default, unless the app asked only to read): create, change, start and stop things, which can cost money, but never delete.
      • Manage and delete: everything Manage can, plus deleting servers, volumes, databases and their data, and anything that wipes data, such as rebuilding a machine.
    • Expires after. 7, 30 (the default) or 90 days. When it expires, the app asks you to approve it again.

    The page shows the app's name with the label Not verified by Pantech. Any app can call itself anything, so check the name and the address it will send you back to before you press Allow. What the label means.

    If the button is greyed out, AI apps are turned off for that organization, and the page says so. An owner can turn them on with Turn on AI apps. See Turn AI apps off for the organization.

    Set up your app

    The same steps are in the console under Organization › AI apps › Connect an AI app. The id in each heading is the one pantech mcp install takes. See Use the CLI to set it up.

    Claude (claude.ai and Claude Desktop) — claude

    1. In Claude, open Settings › Connectors.
    2. Choose Add custom connector, name it Pantech and paste https://mcp.pantechdynamics.com/mcp.
    3. Choose Connect, then allow access on the Pantech page that opens.

    On a Team or Enterprise plan, an admin may need to add the connector first.

    ChatGPT — chatgpt

    1. In ChatGPT, open Settings › Connectors. If you don't see Create, turn on developer mode under Advanced.
    2. Choose Create, name it Pantech, paste https://mcp.pantechdynamics.com/mcp and choose OAuth for authentication.
    3. Allow access on the Pantech page that opens.

    Claude Code — claude-code

    Terminal
    $ claude mcp add --transport http pantech https://mcp.pantechdynamics.com/mcp

    Then run /mcp inside Claude Code, choose pantech and sign in. Allow access on the Pantech page that opens.

    Cursor — cursor

    Add Pantech to ~/.cursor/mcp.json:

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "pantech": { "url": "https://mcp.pantechdynamics.com/mcp" }
      }
    }

    Or open this link, which does the same:

    text
    cursor://anysphere.cursor-deeplink/mcp/install?name=pantech&config=eyJ1cmwiOiJodHRwczovL21jcC5wYW50ZWNoZHluYW1pY3MuY29tL21jcCJ9

    Then, in Cursor's MCP settings, choose Connect next to pantech and allow access on the Pantech page that opens.

    VS Code — vscode

    Terminal
    $ code --add-mcp '{"name":"pantech","type":"http","url":"https://mcp.pantechdynamics.com/mcp"}'

    Or open this link:

    text
    vscode:mcp/install?%7B%22name%22%3A%22pantech%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.pantechdynamics.com%2Fmcp%22%7D

    Start the pantech server when VS Code asks, and allow access on the Pantech page that opens.

    Windsurf — windsurf

    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "pantech": { "serverUrl": "https://mcp.pantechdynamics.com/mcp" }
      }
    }

    Refresh Windsurf's MCP servers and allow access on the Pantech page that opens.

    Codex — codex

    ~/.codex/config.toml
    [mcp_servers.pantech]
    url = "https://mcp.pantechdynamics.com/mcp"

    Then sign in, and allow access on the Pantech page that opens:

    Terminal
    $ codex mcp login pantech

    Gemini CLI — gemini

    Terminal
    $ gemini mcp add --transport http pantech https://mcp.pantechdynamics.com/mcp

    Or add it to ~/.gemini/settings.json yourself. Gemini CLI finds the sign-in on its own: allow access on the Pantech page that opens.

    ~/.gemini/settings.json
    {
      "mcpServers": {
        "pantech": { "httpUrl": "https://mcp.pantechdynamics.com/mcp" }
      }
    }

    Grok (xAI API) — grok

    Grok doesn't sign in: it uses the xAI API's remote MCP tool, and sends a Pantech API key that you create under Organization › API keys. Make it read only unless Grok needs to make changes. Add Pantech to the tools of your xAI API request:

    JSON
    {
      "tools": [
        {
          "type": "mcp",
          "server_url": "https://mcp.pantechdynamics.com/mcp",
          "server_label": "pantech",
          "authorization": "Bearer PAN_…"
        }
      ]
    }

    That key is listed under API keys, not under Connected apps on the AI apps page. Revoke it there.

    Use the CLI to set it up

    The Pantech CLI can write the config for you. It keeps your other MCP servers and saves the old file as <file>.bak. For Claude Code and Gemini CLI it runs their own mcp add command (user scope) when they are installed.

    Terminal
    $ pantech mcp install cursor$ pantech mcp install vscode --print   # show the config, change nothing$ pantech mcp list-clients             # the ids it knows$ pantech mcp status                   # the link, and whether pantech-mcp is installed

    For claude it prints the connector steps above. For chatgpt and grok it prints instructions only, since their setup lives in the app or your request. --url points it at another hosted server.

    Run it locally

    You can also run the MCP server on your own computer. It is a program called pantech-mcp. In this mode there is no browser approval: it uses a key you already have.

    Install it from the releases page (macOS, Linux and Windows), or with Go:

    Terminal
    $ go install github.com/Pantech-Dynamics/pantech-mcp/cmd/pantech-mcp@latest
    Terminal
    $ pantech-mcp stdio

    It looks for a key in this order:

    1. The PANTECH_API_KEY environment variable.
    2. The key the Pantech CLI stored when you ran pantech auth login, from your system's keychain or the CLI's credentials.json. Set PANTECH_PROFILE to pick a profile (PANTECH_CONFIG_DIR if the CLI's settings are somewhere else).

    PANTECH_API_URL points it at another API.

    To point an app at the local server:

    Terminal
    $ pantech mcp install claude-code --local

    That runs claude mcp add --scope user pantech -- <path to pantech-mcp> stdio. The CLI writes the full path, because apps opened from the dock or Start menu may not see your shell's PATH; write the full path too if you edit a config by hand (find it with which pantech-mcp). The same flag works for claude (it writes Claude Desktop's claude_desktop_config.json), cursor, vscode, windsurf, codex and gemini. By hand, the config is the same for most apps:

    claude_desktop_config.json
    {
      "mcpServers": {
        "pantech": { "command": "pantech-mcp", "args": ["stdio"] }
      }
    }

    Restart the app afterwards. For VS Code, run code --add-mcp '{"name":"pantech","type":"stdio","command":"pantech-mcp","args":["stdio"]}'. Codex takes:

    ~/.codex/config.toml
    [mcp_servers.pantech]
    command = "pantech-mcp"
    args = ["stdio"]

    If pantech-mcp is not on your PATH, pantech mcp install --local warns you and writes the config anyway, so install it before you restart the app.

    Was this page helpful?

    Updated