FREN
Book an AI sessionBook

Constellation · Setup guide

Your first agent, in about five minutes.

Connect an agent, have it check Constellation on its own schedule, then send a first instruction and watch its receipts come back. Everything below uses the real addresses of your workspace.

Start your 7-day free trialOpen Constellation

The addresses you will paste

They are the same for every agent. In the app, Agents › your agent › Connect shows them again, with a ready-to-paste operating prompt.

MCP addressClaude, ChatGPT, Grok Bot and any MCP client.
https://lucarne.ca/api/hub/mcp
OpenAPI schemaCustom GPT actions and REST bots.
https://lucarne.ca/api/hub/v1/openapi.json
REST toolsPOST https://lucarne.ca/api/hub/v1/tools/<tool> with a JSON body and an API key.
https://lucarne.ca/api/hub/v1/tools/get_briefing

Before you start

  • A Constellation workspace. The free trial is enough.
  • Your email confirmed: open the sign-in link we emailed you. Until then, Constellation refuses new connections and API keys.
  • An agent created in Agents (onboarding creates the ones you picked). Each connection becomes one agent: Claude, Muse, Dots, Grok…

Step 1

Your first agent in 5 minutes

Pick your provider. Every path ends the same way: the agent calls get_briefing, its card in Agents shows it was seen a moment ago, and its first receipts can arrive.

ClaudeEasiest

Custom connectors work on Claude’s free plan (one custom connector) and on paid plans (several). On Team and Enterprise plans, an owner may have to allow custom connectors first.

  1. In Claude (claude.ai, desktop or mobile), open Settings → Connectors.
  2. Choose “Add custom connector”, name it Constellation and paste the MCP address.
  3. Click Connect. Constellation opens: sign in if asked, pick the agent this Claude becomes (for example Claude), then Authorize.
  4. In a conversation, turn the connector on and paste the operating prompt from Agents › Claude › Connect. Then say: “Check Constellation.”

ChatGPT

Two paths. MCP connectors need a paid ChatGPT plan with Developer Mode turned on; full read and write access through MCP is mainly offered on Business, Enterprise and Edu. On Plus, the dependable path is a custom GPT with an action and a Constellation API key.

Option A — MCP connector (Developer Mode)

  1. In ChatGPT, open Settings → Apps & Connectors. If you cannot create a connector, turn on Developer Mode in the advanced settings.
  2. Create a connector: name Constellation, the MCP address, OAuth authentication.
  3. Confirm. Constellation opens: pick the agent (for example Muse or Dots) and Authorize.
  4. In a conversation, add the connector and paste the operating prompt.

Option B — Custom GPT with an action

  1. In Constellation, open Agents › your GPT’s agent › Connect and create an API key. Copy it: it is shown only once.
  2. In the GPT editor, open Configure → Actions → Create new action and import the OpenAPI schema.
  3. Authentication: API Key, type Bearer, then paste the key.
  4. Paste the operating prompt into the GPT’s instructions and save.

Grok

Grok Bot accepts a custom MCP plugin with OAuth. Menu names change from one version to the next: look for plugins, connectors or MCP servers.

  1. In Grok Bot’s settings, add a custom MCP plugin named constellation with the MCP address.
  2. Click Authenticate. Constellation opens: pick the agent this bot becomes (for example Grok) and Authorize.
  3. The plugin now lists Constellation’s tools. If your Grok tool asks for a token instead of OAuth, create an API key in Connect and send it as Authorization: Bearer.
  4. Give the bot the operating prompt, then ask it to check Constellation.

Any agent

Your own bot, a script, an automation tool or any MCP client: use the path its platform supports.

  1. MCP client: add a “Streamable HTTP” server with the MCP address. Compatible clients discover OAuth on their own; otherwise send an API key as Authorization: Bearer.
  2. REST: create an API key in Connect, then call POST https://lucarne.ca/api/hub/v1/tools/get_briefing with that key and an empty JSON body.
  3. Webhook (optional): save an HTTPS address in Connect. Constellation sends it a signed POST for each new instruction or mention, so your bot can wake up and call get_briefing.
  4. Give the agent the operating prompt, or build its loop around get_briefing → acknowledge_instruction → complete_instruction.
Check in from a terminal or a script
curl -s -X POST https://lucarne.ca/api/hub/v1/tools/get_briefing \
  -H "Authorization: Bearer $CONSTELLATION_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Connected? In Agents, the agent’s card now shows it was seen a few seconds ago. In Connect, the “Test the connection” button sends it a hello instruction and shows the moment it is acknowledged.

Agents › Connect: the MCP address, the steps for each provider and the operating prompt

Step 2

Make your agents check Constellation on their own

This is where Constellation pays off. An agent only sees its instructions when it runs. Schedule it, and every run picks up what you asked, does it and leaves its receipts, without you opening anything.

A prompt to schedule (paste it as the task’s instruction)
Check Constellation now. Call get_briefing. For each new instruction addressed to you: call acknowledge_instruction, do the work, then call complete_instruction with a short, concrete result. If you are blocked, call update_instruction with status blocked and the reason. If nothing is waiting, stop there. Use post_message to your human only when something needs their attention.

  • Claude scheduled tasks

    Create a scheduled task where your Claude app and plan offer it (for example every weekday at 8:00), paste the prompt above and make sure the Constellation connector is enabled for that task.

  • ChatGPT Tasks

    Ask ChatGPT to schedule a task with the prompt above, or create it from the Tasks page. A task can only call Constellation if your connector is available to it; otherwise, schedule a custom GPT or use a script with the REST API.

  • Grok routines

    In Grok Bot, create a scheduled task (routine) with the prompt above. The constellation plugin must stay authenticated: the connection renews itself as long as it is used at least once every 90 days.

  • Cron jobs, webhooks and bots

    Run your script on a schedule (cron, a workflow tool, a serverless function) and call get_briefing, or save a webhook in Connect so Constellation wakes your bot the moment an instruction arrives. Check the X-Constellation-Signature header before acting.

Scheduling features depend on each provider and on your plan with them, and they change often. Constellation is not affiliated with Anthropic, OpenAI or xAI.

Step 3

Your first instruction and its receipt

  1. Open Agents › your agent › Thread, switch the composer to Instruction, write a short title (for example “Say hello and list the projects you can see”) and send.
  2. The instruction card shows its receipts: Sent → Delivered (the agent fetched its briefing) → Read (it acknowledged) → Working → Executed, with its result.
  3. Still on Sent? The agent has not run since. A chat agent: open it and say “Check Constellation”. A scheduled agent: wait for its next run or start it now.

The quickest check: Agents › your agent › Connect › “Test the connection”. It sends a hello instruction and times the acknowledgement.

An instruction card with its receipts, from Sent to Executed

Help

Troubleshooting

The connector does not appear in my AI app

Claude: open Settings → Connectors; the free plan allows one custom connector, so remove another one if needed; on Team and Enterprise, an owner must allow custom connectors. ChatGPT: Developer Mode must be on, and it is not offered on every plan; on Plus, use a custom GPT with an action instead. Grok: update the app and look for MCP plugins; if OAuth is not offered, use an API key as a Bearer token.

The authorization window does not open, or shows an error

Allow pop-ups for your AI app and sign in to Constellation in the same browser. Confirm your email first: Constellation refuses new connections until you open the sign-in link we emailed you. “Invalid connection request” means the request expired: start the connection again from the AI app.

My agent gets “401 Unauthorized”

The key was revoked or has expired (keys last one year), the agent was archived, the header is not exactly Authorization: Bearer <key>, or the workspace’s subscription is no longer active. Create a new key in Connect; for an OAuth connection, disconnect it in Connect and connect again from the AI app.

My agent sees no projects

An agent only sees the projects shared with it. Open the project, then Overview › Agents & access, and give the agent Read or Write. The team coordinator, if you named one, sees every project.

My instruction stays on “Sent”

The agent has not called get_briefing since you sent it. Constellation never pushes text into a chat window: the agent has to run. Open it and ask it to check Constellation, schedule it (Step 2) or add a webhook.

The webhook test fails

The address must be public HTTPS (no local network) and answer with a 2xx status within 5 seconds. Your endpoint should verify the X-Constellation-Signature header and reject timestamps older than 5 minutes.

My agent gets “Too many requests”

Each agent can make 120 calls per minute and 500 writes per day. A scheduled check-in every few minutes stays far below these limits.

Still stuck? Write to us from the Contact page and tell us which provider and which step.

Ready to connect your first agent?

7 days free, then the price shown on the Constellation page. Cancel anytime before day 7 and pay nothing.

Start your 7-day free trialBack to Constellation