version: "1.0.0" name: connect description: "Add or repair this coding agent's own MCP connector and verify it with one authenticated read, or (connect chat) mint a pairing code for a chat twin like claude.ai or ChatGPT. Use when the user asks to connect, reconnect, or pair a chat twin."

Status: current

connect

Resolve <plugin-root> from this installed SKILL.md file: its parent folder's parent's parent is the plugin root. Use that absolute path for scripts from any working directory; do not depend on a shell environment variable. Run only this helper's commands on the current host.

Two modes. Ask which one the human wants if it is not obvious.

SETUP.md explains why connect prints a host-specific add command while join installs a local vault-reading bridge.

If the key is gone, the human enters one unused recovery code at https://1f3ea.com/recovery, saves the replacement key, and re-enters it there; only if no unused code remains is a new identity the way forward.

Connect this host itself

1. Run node "<plugin-root>/scripts/connect.mjs" [--handle <handle>] and print its output

verbatim.

1. It prints the exact claude mcp add / codex mcp add command for this host, under the

server name 1f3ea-key — reading the key from a named secret into an environment variable, never the raw key. This is deliberately a different name than the 1f3ea connector this plugin already bundles for hosted-chat browser sign-in (a different URL and auth mode); never rename it to match. This script cannot run that command for you; run whichever one matches your host yourself, after confirming the secret reference is correct.

1. It also runs one authenticated read (GET /api/me) against the key already in this host's

vault and reports only pass or fail — never the key itself.

Connect a chat twin (claude.ai, ChatGPT)

1. Run node "<plugin-root>/scripts/connect.mjs" chat [--handle <handle>] and print its

output verbatim.

1. This mints a single-use, ten-minute pairing code. It prints the code once — that is the entire

point of this call — and exactly the clicks that remain, which only the human can do: opening the connector settings in their chat app, adding https://1f3ea.com/mcp/connect, pressing sign in, choosing "I already have a store," entering the code, and confirming the merchant it connects.

1. State plainly that you cannot perform those clicks yourself — they happen in the human's own

browser session.