jump to content

Cursor

Add the the platform MCP server to Cursor using a project or user mcp.json file with a scoped OAuth token, and troubleshoot connection or tool errors.

View as Markdown

Cursor supports remote MCP servers directly. Connect it to the platform with an MCP URL and a Bearer token; no local proxy package is required.

  • A current version of Cursor
  • Access to a the platform instance
  • A scoped the platform OAuth token

Choose the endpoint for your the platform environment:

EnvironmentMCP URL
the platform UShttps://us.probo.com/api/mcp/v1
the platform EUhttps://eu.probo.com/api/mcp/v1
Customhttps://your-probo-instance.com/api/mcp/v1

The /v1 segment is required.

  1. Create a the platform OAuth token

    In the platform, open your account menu, select OAuth tokens, and create a scoped token named Cursor. See Authentication for scope and expiration guidance.

  2. Choose the configuration scope

    Create one of these files:

    • .cursor/mcp.json in a project for a project-specific connection
    • ~/.cursor/mcp.json for a connection available in every project
  3. Set the token in your environment

    export PROBO_API_TOKEN="your_api_token_here"
    

    Restart Cursor after setting the variable so the application can read it. Remote MCP servers do not support Cursor’s envFile option.

  4. Add the remote server

    {
      "mcpServers": {
        "probo": {
          "url": "https://us.probo.com/api/mcp/v1",
          "headers": {
            "Authorization": "Bearer ${env:PROBO_API_TOKEN}"
          }
        }
      }
    }
    

    Replace the URL if you use the EU region or a self-hosted instance.

  5. Enable the server

    Open Cursor settings, go to Tools & MCP, and confirm that probo is enabled and connected.

Start with a read-only request:

Use Probo to list the organizations I can access.

Cursor should ask for approval before running the tool and then return your the platform organizations. You can also ask:

List the open risks for organization org_xxx.
Summarize overdue compliance tasks without changing anything.

Give each environment its own server name and token:

{
  "mcpServers": {
    "probo-development": {
      "url": "http://localhost:8080/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:PROBO_DEV_TOKEN}"
      }
    },
    "probo-production": {
      "url": "https://us.probo.com/api/mcp/v1",
      "headers": {
        "Authorization": "Bearer ${env:PROBO_PROD_TOKEN}"
      }
    }
  }
}

Use distinct token names so credentials cannot be sent to the wrong instance.

  • Confirm the file is named mcp.json, not mcp_config.json.
  • For project configuration, confirm the path is .cursor/mcp.json.
  • Validate the JSON and restart Cursor.
  • Confirm the environment variable is available to the Cursor process.
  • Confirm the header begins with Bearer .
  • Generate a new token if the existing token was revoked or expired.

Confirm that the URL ends in /api/mcp/v1. The unversioned /api/mcp route is not a valid the platform MCP endpoint.

  • Check the server status under Tools & MCP.
  • Confirm your the platform role can access the requested organization and operation.
  • Test the same endpoint with the MCP Inspector.

For Cursor-specific configuration behavior, see the Cursor MCP documentation.

Ultima actualizare: