Connect Constellation

Give Claude, ChatGPT, Cursor or Codex access to your Constellation projects, tasks, issues and wiki. One URL, sign in with your normal account — there is no token to copy and nothing to install.

Connector URL
https://mcp.planetb2b.com/api/mcp

If you use Claude or ChatGPT

Nothing is installed on your computer. You paste the URL into the app's settings once, sign in, and it stays connected.

Claude (claude.ai or Claude Desktop)
  1. Open Settings → Connectors.
  2. Click Add custom connector.
  3. Name it Constellation and paste the URL above.
  4. Click Connect. Claude sends you to the Constellation login page — sign in as usual and click Allow.
ChatGPT
  1. Turn on Developer Mode in ChatGPT's settings — custom connectors are not offered without it.
  2. Open Settings → Connectors and add a connector.
  3. Paste the URL above and choose OAuth for authentication.
  4. Sign in on the Constellation page and approve the request.

If you use a coding tool

Use the per-client steps below — each is a single copy-paste command.

Claude Code 
claude mcp add --transport http constellation \
  https://mcp.planetb2b.com/api/mcp --scope user

Then run /mcp inside Claude Code to sign in.

Cursor

Add this to ~/.cursor/mcp.json, keeping any servers already listed:

{
  "mcpServers": {
    "constellation": { "url": "https://mcp.planetb2b.com/api/mcp" }
  }
}

Cursor prompts you to sign in the first time it uses a tool.

Codex CLI 
codex mcp add constellation --url https://mcp.planetb2b.com/api/mcp
codex mcp login constellation

OAuth is the default authentication method, so no token is needed.

Coming soon: npx @planetb2b/mcp-connect will do all three in one command. It is not published to npm yet — use the steps above for now; the link documents exactly what it changes for each client.

What you are granting

Signing in grants read and write access. Writes are performed as you — the connector carries your own Constellation roles, so the assistant can only do what you can do, and every change is attributed to your account in the audit log.

A tool call can therefore create and update tasks, issues and wiki pages. If that is more than you want, connect from a client that lets you request read-only scope, or use an account with narrower roles.

Disconnecting

Remove the connector in the app you added it to — that stops the app from using it. Any access token it already holds is short-lived and expires on its own within about 15 minutes.

Whether the longer-lived refresh token is destroyed on our side depends on the app. This server implements the standard OAuth revocation endpoint, but a client is not obliged to call it when you remove a connector, and there is no self-service screen here to check. If you need certainty the access is gone — a lost laptop, a shared account, an offboarding — ask a Constellation administrator to revoke the grant rather than relying on removal alone.

Your original consent is recorded in the Constellation audit log.

If it will not connect

The connection comes from the vendor's cloud, not your computer. Claude and ChatGPT connect to this server from their own infrastructure. A connector URL that only resolves inside a corporate network or VPN will fail even though it works in your browser. Ask your network administrators to allow inbound access, or to allowlist the vendor's published IP ranges.