Use portal data in your AI tools

1. Add the server for all your projects:

   terminalCopy

   claude mcp add --transport http --scope user portal-data \
     https://3-6-75-122.sslip.io/mcp/ \
     --header "Authorization: Bearer $PORTAL_MCP_TOKEN"

2. Or as JSON. Put this in a project's .mcp.json to share it with that project; each person's own token is filled in from their environment:

   .mcp.jsonCopy

   {
     "mcpServers": {
       "portal-data": {
         "type": "http",
         "url": "https://3-6-75-122.sslip.io/mcp/",
         "headers": { "Authorization": "Bearer ${PORTAL_MCP_TOKEN}" }
       }
     }
   }

3. Check: run claude mcp list, or /mcp inside Claude Code. Then ask “run whoami on portal-data”.

Claude Desktop's “Custom connector” screen can't send a token, so it connects through the mcp-remote bridge. Needs Node.js 18+.

1. Open the config: Settings → Developer → Edit Config (claude_desktop_config.json).

2. Add portal-data under mcpServers, keeping any servers already there:

   claude_desktop_config.jsonCopy

   {
     "mcpServers": {
       "portal-data": {
         "command": "npx",
         "args": ["-y", "mcp-remote", "https://3-6-75-122.sslip.io/mcp/", "--header", "Authorization:${AUTH_HEADER}"],
         "env": { "AUTH_HEADER": "Bearer pmcp_YOUR_TOKEN" }
       }
     }
   }

3. Quit and reopen Claude Desktop. portal-data appears under the tools icon in the chat box.

Works for the Codex CLI and the Codex IDE extension (they share one config). Set PORTAL_MCP_TOKEN first.

1. Add the server:

   terminalCopy

   codex mcp add portal-data \
     --url https://3-6-75-122.sslip.io/mcp/ \
     --bearer-token-env-var PORTAL_MCP_TOKEN

2. Or edit the config (Codex uses TOML, not JSON):

   ~/.codex/config.tomlCopy

   [mcp_servers.portal-data]
   url = "https://3-6-75-122.sslip.io/mcp/"
   bearer_token_env_var = "PORTAL_MCP_TOKEN"

3. Check: codex mcp list, or /mcp inside Codex. Then ask “use portal-data to run whoami”.

1. Add the server in Cursor Settings → Tools & MCP → New MCP Server, or edit the file directly:

   ~/.cursor/mcp.jsonCopy

   {
     "mcpServers": {
       "portal-data": {
         "url": "https://3-6-75-122.sslip.io/mcp/",
         "headers": { "Authorization": "Bearer ${env:PORTAL_MCP_TOKEN}" }
       }
     }
   }

   If it shows as unauthorized, update Cursor; if it still fails, paste the token in place of ${env:PORTAL_MCP_TOKEN}. Never put a token in a project .cursor/mcp.json that's committed to git.

2. Restart Cursor. portal-data shows a green dot under Tools & MCP. In Agent chat, ask “run whoami with portal-data”.

For claude.ai in the browser. The connector sends your token as a request header.

1. Open Customize → Connectors → Add custom connector.

2. Name and URL: give it a name (e.g. Portal MCP) and this URL:

   URLCopy

   https://3-6-75-122.sslip.io/mcp/

3. Authentication: choose No sign-in (not “Sign in now”, even if it shows as detected).

4. Request headers: add one header:

   header nameCopy

   X-API-Key

   header valueCopy

   pmcp_YOUR_TOKEN

5. Save, turn the connector on in a chat (the “+” / tools menu), and ask “run whoami”.

Any script or tool can call the REST API with the same token. Every data route needs env=beta or env=prod.

curl -H "Authorization: Bearer $PORTAL_MCP_TOKEN" \
  "https://3-6-75-122.sslip.io/api/courses?env=beta&q=html.*css"

import os, requests

r = requests.get("https://3-6-75-122.sslip.io/api/courses",
                 params={"env": "beta", "q": "html.*css"},
                 headers={"Authorization": f"Bearer {os.environ['PORTAL_MCP_TOKEN']}"},
                 timeout=60)
print(r.json())

const token = PropertiesService.getScriptProperties().getProperty("PORTAL_MCP_TOKEN");
const res = UrlFetchApp.fetch("https://3-6-75-122.sslip.io/api/courses?env=beta&q=" + encodeURIComponent("html.*css"),
  { headers: { Authorization: "Bearer " + token } });
Logger.log(JSON.parse(res.getContentText()));

Interactive reference: https://3-6-75-122.sslip.io/api/docs (Authorize → paste token). Spec as JSON: https://3-6-75-122.sslip.io/api/openapi.json.