# Connecting

The simplest way to use Ninjo is to add it as a **connector** in Claude — it works the same in the Claude app *and* in your browser. It comes in **two parts**: first connect the tools, then give Claude the playbook so it builds agents the right way. **Do both** — the second part is the one people skip, and it's the difference between a real agent and a good-looking prompt. Prefer **ChatGPT** or **Claude Code**? There are setups for both at the bottom.

## Part 1 — add the Ninjo connector  · recommended

Works in the **Claude app** (Mac or Windows) and in your browser at **claude.ai**. You'll paste one address — here it is (use the copy button):

> https://cortex-gateway.ninjoaiplatform.com/mcp

Then, in Claude:

1. Open **Settings → Connectors** and click **Add custom connector**.
2. Name it **Ninjo**, and paste the address above into **Remote MCP server URL**.
3. Leave the OAuth fields blank (under *Advanced settings*) and click **Add**.
4. When it asks, log in with your **Ninjo email and password**.
5. In a chat, turn the **Ninjo** connector on — the **+** menu → connectors → toggle it.
6. Ask **"list my agents"** to confirm the tools are connected. **Now do Part 2 — don't stop here.**

<aside class="callout">💳 <strong>Heads up:</strong> custom connectors need a paid Claude plan (Pro, Max, Team, or Enterprise). If you don't see <em>Add custom connector</em>, you're on the free plan — use the Claude Code way below instead, or ask us about the hosted web app.</aside>

---

## Part 2 — give Claude the playbook  · don't skip this

The connector hands Claude the **buttons**. The playbook teaches it **which buttons to press, and when** — because 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. Skip this and Claude will happily write you a nice-sounding prompt that quietly misses all of that.

The playbook lives in the Ninjo project — so you hand it over by giving Claude the **whole project**:

<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>

1. Click the button above to download the project as a single **.zip** — no account, no sign-in.
2. In Claude, create a **Project** (sidebar → **Projects** → **New project**) and name it **Ninjo**. A Project is just a folder for your chats that keeps things together across conversations.
3. Start a chat inside that Project and **attach the whole `.zip`** (the **+** / paperclip → upload). The important word is *whole* — attach the **entire** file, not a handful of pages you picked out. <strong>This is exactly where one early agent went wrong: only a few files were added instead of the full project, so Claude never saw the playbook and built a plain prompt.</strong>
4. Turn the **Ninjo** connector on in that same chat, and always work from this Project. Re-attach the `.zip` at the start of each new conversation (and whenever you download a newer version).

That's the whole setup: **tools + playbook, together in one Project.**

---

## 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.)

---

## Prefer ChatGPT (OpenAI)?  · works there too

Ninjo connects to ChatGPT the same way — ChatGPT just calls connectors **apps**. You'll paste the same address:

> https://cortex-gateway.ninjoaiplatform.com/mcp

In ChatGPT:

1. Open **Settings → Apps** and click **Create app** — the **New App** dialog opens.
2. Name it **Ninjo** (the description is optional).
3. Under **Connection**, keep **Server URL** selected and paste the address above.
4. Set **Authentication** to **OAuth**, and leave **Advanced OAuth settings** as they are.
5. ChatGPT warns that custom MCP servers "introduce risk" and that "OpenAI hasn't reviewed this MCP server" — that's the standard notice for *any* custom connector, not something wrong with Ninjo. Tick **I understand and want to continue** and finish.
6. When it asks, log in with your **Ninjo email and password**.
7. In a chat, turn the **Ninjo** app on and ask **"list my agents"** to confirm the tools are connected.

<aside class="callout">💳 <strong>Heads up:</strong> custom apps need a paid ChatGPT plan, and you may have to switch on <em>developer mode</em> for connectors under <em>Settings → Apps</em> first. If you don't see <em>Create app</em>, your plan doesn't include custom connectors — use Claude instead, or ask us about the hosted web app.</aside>

**Then do Part 2 here too — don't stop at the tools.** The app gives ChatGPT the buttons; it still needs the playbook to know which to press. Download the project `.zip` above and attach it to your chat (a ChatGPT **Project** keeps it handy across conversations), the same as Part 2, so ChatGPT builds a real agent and not just a nice-sounding prompt.

---

## Prefer Claude Code?  · the hands-on way

If you work inside Claude Code, get the project first, then log in.

### Get the project

The simplest way — no technical steps — is to download it as a folder:

<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>

1. Click the button — it downloads right away, no account or sign-in needed.
2. Unzip the file you downloaded (double-click it on a Mac, or right-click → *Extract All* on Windows).
3. Open that folder in Claude Code — then log in below.

### Log in

<div class="tabs" data-tabs>
  <div class="tab-btns">
    <button class="tab-btn on" data-tab="terminal"><span class="ti">⌨️</span>Terminal</button>
    <button class="tab-btn" data-tab="web"><span class="ti">🌐</span>Web / cloud</button>
  </div>
  <div class="tab-panel on" data-panel="terminal">
    <span class="pill easy">Easiest</span>
    <h4>Claude Code in your terminal</h4>
    <ol>
      <li>Open the <code>cortex-ops</code> folder in Claude Code.</li>
      <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="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.</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 also <code>cortex-ops-wiki.pages.dev</code> 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).

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