# Connecting

Ninjo works wherever you already chat with AI — the **Claude** app or browser, **ChatGPT**, or **Claude Code**. Pick your tool below and you'll see just the steps that apply to you. Most people are connected in about two minutes.

<div class="tabs" data-tabs>
  <div class="tab-btns">
    <button class="tab-btn on" data-tab="claude"><span class="ti">💬</span>Claude · app / browser</button>
    <button class="tab-btn" data-tab="chatgpt"><span class="ti">🤖</span>ChatGPT</button>
    <button class="tab-btn" data-tab="cc-term"><span class="ti">⌨️</span>Claude Code · terminal</button>
    <button class="tab-btn" data-tab="cc-web"><span class="ti">🌐</span>Claude Code · web</button>
  </div>
  <div class="tab-panel on" data-panel="claude">
    <span class="pill easy">Recommended</span>
    <h4>Add the Ninjo connector</h4>
    <p class="lead-note">Works the same in the Claude desktop app (Mac or Windows) and in your browser at claude.ai. You'll paste one address:</p>
    <blockquote>https://cortex-gateway.ninjoaiplatform.com/mcp</blockquote>
    <ol>
      <li>Open <strong>Settings → Connectors</strong> and click <strong>Add custom connector</strong>.</li>
      <li>Name it <strong>Ninjo</strong> and paste the address above into <strong>Remote MCP server URL</strong>.</li>
      <li>Leave the OAuth fields blank (under <em>Advanced settings</em>) and click <strong>Add</strong>.</li>
      <li>When it asks, log in with your <strong>Ninjo email and password</strong>.</li>
      <li>In a chat, turn the <strong>Ninjo</strong> connector on — the <strong>+</strong> menu → connectors → toggle it.</li>
      <li>Ask <em>"list my agents"</em> to confirm you're connected.</li>
    </ol>
    <aside class="callout">💳 <strong>Heads up:</strong> custom connectors need a paid Claude plan (Pro, Max, Team, or Enterprise). No <em>Add custom connector</em> button? You're on the free plan — use the <strong>Claude Code · terminal</strong> tab instead, or ask us about the hosted web app.</aside>
    <p class="lead-note">✅ That's the whole setup — the connector also loads Ninjo's playbook automatically, so your agent is built the right way. Want to go deeper? The optional project download below gives Claude the full reference.</p>
  </div>
  <div class="tab-panel" data-panel="chatgpt">
    <h4>Add the Ninjo app</h4>
    <p class="lead-note">Ninjo is now an <strong>approved ChatGPT app</strong> — no custom connector, no pasted URL, no developer mode. You just search for it.</p>
    <ol>
      <li>Open <strong>Settings → Apps &amp; Connectors</strong> (or the <strong>+</strong> / apps menu inside a chat).</li>
      <li><strong>Search for "Ninjo"</strong> in the app directory and open it.</li>
      <li>Click <strong>Connect</strong>, and when it asks, log in with your <strong>Ninjo email and password</strong>.</li>
      <li>In a chat, turn the <strong>Ninjo</strong> app on and ask <em>"list my agents"</em> to confirm.</li>
    </ol>
    <aside class="callout">💳 <strong>Heads up:</strong> apps need a paid ChatGPT plan, and the directory is still rolling out. Don't see Ninjo yet? Reach out and we'll get you connected.</aside>
    <p class="lead-note">✅ The app also loads Ninjo's playbook automatically. Want to go deeper? The optional project download below gives ChatGPT the full reference.</p>
  </div>
  <div class="tab-panel" data-panel="cc-term">
    <span class="pill easy">Easiest for Claude Code</span>
    <h4>1 · Get the project</h4>
    <p class="lead-note">Claude Code works from files on your machine, so here the download <strong>isn't optional</strong> — it's how Claude Code gets Ninjo's skills and playbook.</p>
    <a class="dl-btn" href="/cortex-ops.zip"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M8 1a.75.75 0 01.75.75v6.69l2.22-2.22a.75.75 0 111.06 1.06l-3.5 3.5a.75.75 0 01-1.06 0l-3.5-3.5a.75.75 0 111.06-1.06l2.22 2.22V1.75A.75.75 0 018 1zM2.75 13a.75.75 0 000 1.5h10.5a.75.75 0 000-1.5H2.75z"/></svg>Download the project<span class="hint">.zip</span></a>
    <ol>
      <li>Click the button — it downloads right away, no account or sign-in needed.</li>
      <li>Unzip it (double-click on a Mac, or right-click → <em>Extract All</em> on Windows).</li>
      <li>Open that <code>cortex-ops</code> folder in Claude Code.</li>
    </ol>
    <h4>2 · Log in</h4>
    <ol>
      <li>Type <code>/mcp</code> and press enter. A browser opens to the Ninjo login.</li>
      <li>Enter your Ninjo email and password — it stays saved for next time.</li>
      <li>To check it worked, type: <em>list my agents</em>.</li>
    </ol>
  </div>
  <div class="tab-panel" data-panel="cc-web">
    <span class="pill">A few extra steps</span>
    <h4>Claude Code on the web (cloud)</h4>
    <p class="lead-note">The cloud version can't open a browser for you, so the login is a bit more hands-on — you only do it once. It runs from the connected repo, so there's no download here.</p>
    <ol>
      <li><strong>Allow the gateway address.</strong> In the environment's network settings, switch from <strong>Trusted</strong> to <strong>Custom</strong> and add <code>cortex-gateway.ninjoaiplatform.com</code> — and <code>cortex-ops-wiki.pages.dev</code> too if you want the automatic "newer version available" check to run.</li>
      <li><strong>Connect the project</strong> (the <code>ninjo-ai/cortex-ops</code> repository) and the <code>cortex-gateway</code> server.</li>
      <li><strong>Get the login link.</strong> Type <code>/mcp</code>. Claude hands you a link — open it, log in with your Ninjo email and password.</li>
      <li><strong>Give the link back.</strong> Copy the link it sends you to afterward and paste it back to Claude → <em>login successful</em>.</li>
      <li>To check it worked, ask: <em>list my agents</em>.</li>
    </ol>
  </div>
</div>

Once you're connected, head to [Getting started](getting-started.md) to learn the rhythm — or jump straight to [all the use cases](index.md).

---

## The playbook — what makes a *real* agent

A real agent isn't just a chat prompt — it's a whole **system**: the follow-ups that re-engage people who went quiet, the alert that pings you the moment someone books, the limit that stops the agent from messaging someone who already said yes. The **playbook** is what teaches Claude to build all of that instead of a good-looking prompt that quietly misses it.

- **In Claude or ChatGPT** — good news: the connector now hands over the playbook **automatically**, so you get a real agent by default. Downloading the project is an **optional nice-to-have** — attach the `.zip` inside a **Project** when you want Claude to have the deepest possible reference (the full sample agents, templates, and knowledge base) for a tricky build.
- **In Claude Code** — the project files **are** the playbook: the skills, the operating manual, and the samples all live in the folder you open. That's why the download is a **required** step in the Claude Code tabs above, not an extra.

<a class="dl-btn" href="/cortex-ops.zip"><svg viewBox="0 0 16 16" aria-hidden="true"><path d="M8 1a.75.75 0 01.75.75v6.69l2.22-2.22a.75.75 0 111.06 1.06l-3.5 3.5a.75.75 0 01-1.06 0l-3.5-3.5a.75.75 0 111.06-1.06l2.22 2.22V1.75A.75.75 0 018 1zM2.75 13a.75.75 0 000 1.5h10.5a.75.75 0 000-1.5H2.75z"/></svg>Download the project<span class="hint">.zip</span></a>

If you do use a **Project** (in Claude or ChatGPT), attach the **whole** `.zip` — the entire file, not a handful of pages you picked out — and re-attach it whenever you download a newer version. A Project keeps it handy across conversations.

---

## Managing several creators?  · for agencies

If your Ninjo login covers **more than one creator** (an agency account), you don't have to remember any IDs. Just tell the agent which creator you mean **by their Instagram @handle** — *"set up the welcome message for @fitwithana"* — and it works on that one. Behind the scenes each creator has a unique identifier that the agent uses for you; the @handle is just the friendly label. Ask **"which creators can I manage?"** and it'll list them by handle. (If a single-creator login is all you have, you can skip this — everything you ask just applies to your one account.)

---

← Back to the [wiki home](index.md)
