Guide · Developers

Connect Claude Code to Startr

Two minutes in the terminal, one approval on your iPhone. After that, any Claude Code session can keep a live card on your Lock Screen.

About 2 minutesOnce per machine

You'll need

Step 1 · Terminal

Add the connector

  1. Run this once:
    claude mcp add --transport http startr https://nfhuxlzifqtxfaqjfsnp.supabase.co/functions/v1/startr-connector-oauth/mcp

    The address is public; it isn't a secret. Your credential is created during sign-in and stays with Claude Code.

  2. Start Claude Code, type /mcp, choose startr and then Authenticate. A Startr page opens in your browser and asks for an invitation code.
Step 2 · iPhone

Approve it

  1. In Startr, go to Settings › Agent Cards and tap Create setup invitation. Type the code on the Startr page in your browser.

    Type it on the Startr page, not into a chat. Codes expire in five minutes.

  2. Tap Refresh pairing requests, check the confirmation codes match, and tap Allow. Back in /mcp, startr should show connected.
Step 3 · Try it

Your first card

  1. In Claude Code:
    Put a two-minute test countdown on my Startr, then end it with a checkmark.
    Lock your phone and watch it appear.
  2. Make it automatic. Add this to your project's CLAUDE.md:
    For any task likely to take more than two minutes, keep a Startr card updated with the current step and progress, and end it with the result. Ask on Startr before running a long test suite.
If something doesn't work

Quick fixes

/mcp shows startr as failed

Choose Authenticate again and finish the approval on your phone. If it still fails, remove it with claude mcp remove startr and run the add command again.

The card doesn't show up

Turn on Live Activities in Settings › Startr. On Free, only one card can be live, so ask Claude to end any old card first.

“Connector operation denied”

Usually the one free card slot is in use. End the open card, or upgrade to Pro for five.

Using Codex?

Codex connects with a URL and a private header instead. See setup.

Next: real work

See prompts for refactors, test gates and multi-stage jobs.

Startr for developers