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.
You'll need
- Startr on your iPhone
- Claude Code installed
- Using claude.ai or Grok instead? See Connect Claude or setup.
Add the connector
- Run this once:
claude mcp add --transport http startr https://nfhuxlzifqtxfaqjfsnp.supabase.co/functions/v1/startr-connector-oauth/mcpThe address is public; it isn't a secret. Your credential is created during sign-in and stays with Claude Code.
- Start Claude Code, type /mcp, choose startr and then Authenticate. A Startr page opens in your browser and asks for an invitation code.
Approve it
- 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.
- Tap Refresh pairing requests, check the confirmation codes match, and tap Allow. Back in /mcp, startr should show connected.
Your first card
- In Claude Code:Lock your phone and watch it appear.Put a two-minute test countdown on my Startr, then end it with a checkmark.
- 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.
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.