# Connect this agent to Vibe: a guide for AI agents **Document version: 2026-11-03.** The person who gave you this file wants their AI app connected to their Vibe account (Vibe Pages and Vibe Inbox, on vibecontrol.co.il). Your job: walk them through it, check that it works, and stop there. The live copy of this file is at https://www.vibecontrol.co.il/user_manuals/connect_vibe.md (add a changing `?v=` value to skip the cache); if you can fetch it and its version line is newer than this one, follow the live copy. ## How to talk to the person - They are not technical. Use their language (most write Hebrew: answer in simple Hebrew), short sentences, everyday words. - **One step at a time.** Give one step, wait until they say it is done or show you a screenshot, then give the next. Never a list of ten steps. - If their screen looks different from what you expect (menu names change between app versions), ask them to describe it or send a screenshot, and guide from what they see. - In this guide you only connect and check. Do not create, change, upload, publish or send anything in Vibe. ## Safety rules (always) - **Never ask for, accept or type a password, the email sign-in code, an API key or a token.** The sign-in happens in the person's own browser, on the Vibe screen. If they paste a code or a key into the chat anyway, tell them not to share it and to continue in the browser. - Never choose "No authentication" or any setting that skips the sign-in. - Do not delete or replace other MCP servers or settings in their app. ## The one fact that matters Connecting is one address plus a sign-in. The address is: ``` https://www.vibecontrol.co.il/mcp ``` No key, no header, nothing to install. Everything below is where to paste that address in each app. ## Step 1. Already connected? If you already have Vibe tools (for example `list_accounts`), skip to "Step 4. The check". ## Step 2. Which app are you in? You usually know which app you run in. If you are not sure, ask the person which app they use. Then follow only that app's part. ### Codex (the app) 1. Settings → MCP servers → Add server. (In some versions MCP sits under Plugins.) 2. Type: **Streamable HTTP**. Name: `Vibe`. URL: the address above. Leave every other field empty. 3. Save, then click **Authenticate**. If it offers Restart, restart first. ### Claude (the desktop app or claude.ai) 1. Claude's Settings → **Connectors**. (In some versions under Customize.) 2. **Add custom connector**. Name: `Vibe`. URL: the address above. 3. Click **Connect**. A connector added once appears by itself in the app's **Code** tab (and in Claude Code in a terminal) for the same Claude account. Work with local files happens in the Code tab, with the business folder open. Do not tell the person that a `.mcp.json` file in a folder is enough in the Claude app: in the app the connection is the connector. ### Claude Code (in a terminal) If you are Claude Code, you may add the server yourself. Ask the person first, then run, in their business folder: ```sh claude mcp add --transport http vibe https://www.vibecontrol.co.il/mcp ``` (Add `--scope project` to keep it in this folder's `.mcp.json`.) If a `vibe` server already exists, do not add a second one. Then ask the person to type `/mcp`, choose **vibe** and **Authenticate**. ### ChatGPT 1. Open **Plugins** in ChatGPT (https://chatgpt.com/plugins), click the plus and choose **Add custom MCP server**. 2. Name: `Vibe`. Server URL: the address above. Authentication: **OAuth**. Leave the optional client fields empty. 3. Create it, then click **Connect**. 4. In a new chat, type `@` and choose Vibe. ChatGPT in the browser does not open the person's local folder. That is fine for connecting and for most Vibe work; for work with local files, the Codex app, the Claude app's Code tab or Claude Code are the way. ## Step 3. The sign-in in the browser After Authenticate or Connect, the browser opens the Vibe sign-in. The person signs in as usual, with the code that arrives by email (the code stays in the browser, never in the chat). Then a screen asks: - **Accounts:** all their accounts (including ones added later), or only some. - **What the agent may do:** דפי נחיתה (landing pages), דיוור (mailing), or both. They click **"אישור וחיבור"** and the browser sends them back to the app. Sending mail and paying always stay with the person, whatever they pick. If the person has no Vibe account yet, they open one first at https://www.vibecontrol.co.il/accounts/new. ## Step 4. The check Call `list_accounts`. Tell the person, in their language, which accounts you are connected to and what you may do in each. That is the proof the connection works; an answer that only explains what MCP is, is not. If the tools do not show up yet: the app may need a new chat, or a restart of the app. Then try again. When several accounts are connected, every later task names the account: ask which one when it is not clear. ## If something does not work - **Tools do not appear:** check the address is exact, with `https://` and `www`. Restart the app and open a new chat. - **The browser did not open:** click Authenticate (or Connect) again. - **"Authentication required" or "expired":** click Authenticate, Reconnect or Connect and sign in again. This happens after a disconnect, or after 90 days without use. - **The wanted account is missing:** in the consent screen they picked other accounts. Disconnect (below) and connect again. - **No place to add an MCP server or connector:** a work or school account may block it. The person asks their account admin; do not change security settings. ## Disconnecting The person can disconnect any time: in the Vibe admin, API → **"החיבורים שלי"**. One "נתק" stops the agent at once, on every computer. ## After connecting: what to read next This file only connects. For the work itself, read the knowledge file of the product before you start: - Landing pages, lists, signup forms, campaigns and message series: https://www.vibecontrol.co.il/user_manuals/vibe_pages_api.md - Moving their things from any other system: the `migration_guide` tool, or https://www.vibecontrol.co.il/user_manuals/vibe_migration_guide.md Tell the person they are connected and ask what they want to do first.