Cards / playbooks / connect-claude

Connect Claude to your Edgible

Chapter 2 of Your own AI agent, from anywhere. New: tested on our own machines, so tell us how it goes.

So far, Claude Code on your computer does the work. This chapter lets every Claude do it: the Claude app on your phone, on your desktop, and on the web. Ask what's running, whether something answers, or for a new app, from wherever you are.

It works through a connector: a small service on your own machine that Claude's apps call, behind your Edgible sign-in. It also gives you key links, so you can store an AI provider's key without ever pasting it into a chat.

What you need

  • Chapter 1 done.
  • Claude on a paid plan, on your computer, and the Claude app on your phone.

1. Set up the connector

In Claude Code, on your own computer, say:

Connect Claude to my Edgible: set up the Edgible connector on my edgible-vm, and allow it to make changes on that machine only.

It sets the connector up on your machine and gives it its own web address. Along the way it asks you to approve one more sign-in, with a link and a code as in chapter 1: that lets the connector act for your Edgible account. It is a separate sign-in from chapter 1's, so check again that the page names the account you mean to use. Claude reads the account back before it goes on.

Along the way it may find and fix small problems, such as the clock on a virtual machine, and it tells you what it did. If you already have a connector, it says so, and you can keep using that one.

At the end, it gives you the connector's address. Copy it: it ends in /mcp. Lost it? Ask: "What's my Edgible connector's address?"

2. Add it to Claude

In the Claude app on your computer, or at claude.ai:

  1. Open Settings, then Connectors, then Add custom connector.
  2. Name it Edgible, paste the address, and choose Add.
  3. Choose Connect. An Edgible page opens: sign in with your Edgible account, and allow Claude. This is the third time you sign in to Edgible, and the last: this one lets Claude, not your machine, act for your account. Check the page names the account you mean to use.

That's all. Your phone's Claude app picks it up by itself, since it's the same Claude account.

If Claude says it couldn't check the server or couldn't register, check the address: it ends in /mcp, and it doesn't have -login in it. That one is the sign-in page you see, not the connector.

3. Try it from your phone

In the Claude app on your phone, start a new chat and ask:

What's running on my Edgible?

It should list your machine and the connector itself. Claude asks before it changes anything, every time.

What you've just done

You've put Edgible in your pocket:

Prefer to do it by hand?

What Claude does, in order. Each step is in the edgible-connector card (opens in a new tab)'s README, which our regression runs as written.

  1. On the machine, the edgible-connector card. In its card.env: DEVICE (this machine's Edgible name), ORG_LABEL, and, to let Claude make changes, EDGIBLE_MCP_ALLOW_WRITE=1 with EDGIBLE_MCP_DEVICES set to this machine. Then Check and Start.
  2. Sign its Edgible tools in, once: the README's edgible auth login --no-browser inside the edgible-mcp container, then open the link and approve.
  3. Publish its two addresses: mcp-signin on none (the connector) and mcp-signin-login on org (the sign-in page).
  4. In Claude: Settings, Connectors, Add custom connector, with https://<mcp-signin address>/mcp.

See what Claude did. Every change it makes through the connector is recorded on your machine: ask "Show me what you've changed on my Edgible" at any time.

This page as Markdown, for your AI assistant