# Conectarte

La forma más simple de usar Ninjo es agregarlo como **conector** en Claude — funciona igual en la app de Claude *y* en tu navegador. Tiene **dos partes**: primero conectás las herramientas, y después le pasás a Claude el manual de juego para que arme los agentes como corresponde. **Hacé las dos** — la segunda es la que todos se saltean, y es la diferencia entre un agente de verdad y un prompt que suena lindo. ¿Preferís **ChatGPT** o **Claude Code**? Hay setups para los dos al final.

## Parte 1 — agregar el conector de Ninjo  · recomendado

Funciona en la **app de Claude** (Mac o Windows) y en tu navegador en **claude.ai**. Vas a pegar una sola dirección — acá está (usá el botón de copiar):

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

Después, en Claude:

1. Abrí **Settings → Connectors** y hacé clic en **Add custom connector**.
2. Ponele de nombre **Ninjo**, y pegá la dirección de arriba en **Remote MCP server URL**.
3. Dejá los campos de OAuth en blanco (en *Advanced settings*) y hacé clic en **Add**.
4. Cuando te lo pida, iniciá sesión con tu **email y contraseña de Ninjo**.
5. En un chat, activá el conector **Ninjo** — el menú **+** → connectors → activalo.
6. Pedile **"listame mis agentes"** para confirmar que las herramientas quedaron conectadas. **Ahora hacé la Parte 2 — no te quedes acá.**

<aside class="callout">💳 <strong>Ojo:</strong> los conectores personalizados necesitan un plan pago de Claude (Pro, Max, Team o Enterprise). Si no ves <em>Add custom connector</em>, estás en el plan gratis — usá la forma con Claude Code de abajo, o preguntanos por la app web.</aside>

---

## Parte 2 — pasale a Claude el manual de juego  · no te lo saltees

El conector le da a Claude los **botones**. El manual de juego le enseña **qué botón apretar y cuándo** — porque un agente de verdad no es solo un prompt de chat, es todo un **sistema**: los seguimientos que reactivan a quienes quedaron en silencio, el aviso que te llega apenas alguien agenda, el límite que evita que el agente le siga escribiendo a alguien que ya dijo que sí. Si te salteás esto, Claude te va a escribir un prompt que suena lindo pero que se pierde todo eso.

El manual de juego vive en el proyecto de Ninjo — así que se lo pasás dándole a Claude el **proyecto entero**:

<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>Descargar el proyecto<span class="hint">.zip</span></a>

1. Hacé clic en el botón de arriba para descargar el proyecto como un solo **.zip** — sin cuenta, sin inicio de sesión.
2. En Claude, creá un **Project** (barra lateral → **Projects** → **New project**) y ponele de nombre **Ninjo**. Un Project es simplemente una carpeta para tus chats que mantiene todo junto entre conversaciones.
3. Abrí un chat dentro de ese Project y **adjuntá el `.zip` entero** (el **+** / clip → subir archivo). La palabra clave es *entero* — adjuntá el archivo **completo**, no unas pocas páginas que elegiste a mano. <strong>Acá es justo donde un agente temprano se desvió: se cargaron solo algunos archivos en vez del proyecto completo, así que Claude nunca vio el manual de juego y armó un prompt pelado.</strong>
4. Activá el conector **Ninjo** en ese mismo chat, y trabajá siempre desde este Project. Volvé a adjuntar el `.zip` al empezar cada conversación nueva (y cada vez que descargues una versión más nueva).

Listo, ese es todo el setup: **herramientas + manual de juego, juntos en un mismo Project.**

---

## ¿Manejás varios creators?  · para agencias

Si tu login de Ninjo abarca **más de un creator** (una cuenta de agencia), no tenés que acordarte de ningún ID. Simplemente decile al agente sobre cuál creator querés trabajar **por su @handle de Instagram** — *"armá el mensaje de bienvenida de @fitwithana"* — y trabaja sobre ese. Por detrás cada creator tiene un identificador único que el agente usa por vos; el @handle es solo la etiqueta fácil de reconocer. Pedile **"¿qué creators puedo manejar?"** y te los lista por handle. (Si tu login es de un solo creator, podés saltearte esto — todo lo que pidas aplica a tu única cuenta.)

---

## ¿Preferís ChatGPT (OpenAI)?  · también funciona ahí

Ninjo se conecta a ChatGPT de la misma forma — ChatGPT a los conectores les dice **apps**. Vas a pegar la misma dirección:

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

En ChatGPT:

1. Abrí **Settings → Apps** y hacé clic en **Create app** — se abre el cuadro **New App**.
2. Ponele de nombre **Ninjo** (la descripción es opcional).
3. En **Connection**, dejá seleccionado **Server URL** y pegá la dirección de arriba.
4. Poné **Authentication** en **OAuth**, y dejá **Advanced OAuth settings** como están.
5. ChatGPT avisa que los servidores MCP personalizados "introducen riesgo" y que "OpenAI no revisó este servidor MCP" — es el aviso estándar para *cualquier* conector personalizado, no algo malo de Ninjo. Tildá **I understand and want to continue** y terminá.
6. Cuando te lo pida, iniciá sesión con tu **email y contraseña de Ninjo**.
7. En un chat, activá la app **Ninjo** y pedile **"listame mis agentes"** para confirmar que las herramientas quedaron conectadas.

<aside class="callout">💳 <strong>Ojo:</strong> las apps personalizadas necesitan un plan pago de ChatGPT, y puede que primero tengas que activar el <em>modo desarrollador</em> para conectores en <em>Settings → Apps</em>. Si no ves <em>Create app</em>, tu plan no incluye conectores personalizados — usá Claude, o preguntanos por la app web.</aside>

**Después hacé también la Parte 2 — no te quedes en las herramientas.** La app le da a ChatGPT los botones; igual necesita el manual de juego para saber cuál apretar. Descargá el `.zip` del proyecto de arriba y adjuntalo a tu chat (un **Project** de ChatGPT lo mantiene a mano entre conversaciones), igual que en la Parte 2, para que ChatGPT arme un agente de verdad y no un prompt que suena lindo.

---

## ¿Preferís Claude Code?  · la forma manual

Si trabajás dentro de Claude Code, primero conseguí el proyecto y después entrá.

### Conseguir el proyecto

La forma más simple — sin pasos técnicos — es descargarlo como una carpeta:

<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>Descargar el proyecto<span class="hint">.zip</span></a>

1. Hacé clic en el botón — se descarga al toque, sin cuenta ni inicio de sesión.
2. Descomprimí el archivo que bajaste (doble clic en Mac, o clic derecho → *Extraer todo* en Windows).
3. Abrí esa carpeta en Claude Code — y después entrá abajo.

### Entrar

<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 / nube</button>
  </div>
  <div class="tab-panel on" data-panel="terminal">
    <span class="pill easy">Lo más fácil</span>
    <h4>Claude Code en tu terminal</h4>
    <ol>
      <li>Abrí la carpeta <code>cortex-ops</code> en Claude Code.</li>
      <li>Escribí <code>/mcp</code> y apretá enter. Se abre el navegador en el login de Ninjo.</li>
      <li>Poné tu email y contraseña de Ninjo — queda guardado para la próxima.</li>
      <li>Para confirmar que funcionó, escribí: <em>listame mis agentes</em>.</li>
    </ol>
  </div>
  <div class="tab-panel" data-panel="web">
    <span class="pill">Unos pasos extra</span>
    <h4>Claude Code en la web (nube)</h4>
    <p class="lead-note">La versión en la nube no puede abrir el navegador por vos, así que el login es un poco más manual. Lo hacés una sola vez.</p>
    <ol>
      <li><strong>Permití la dirección del gateway.</strong> En la configuración de red del entorno, cambiá de <strong>Trusted</strong> a <strong>Custom</strong> y agregá <code>cortex-gateway.ninjoaiplatform.com</code> — y también <code>cortex-ops-wiki.pages.dev</code> si querés que corra el chequeo automático de "hay una versión nueva".</li>
      <li><strong>Conectá el proyecto</strong> (el repositorio <code>ninjo-ai/cortex-ops</code>) y el servidor <code>cortex-gateway</code>.</li>
      <li><strong>Conseguí el link de login.</strong> Escribí <code>/mcp</code>. Claude te da un link — abrilo, iniciá sesión con tu email y contraseña de Ninjo.</li>
      <li><strong>Devolvé el link.</strong> Copiá el link al que te manda después y pegáselo de vuelta a Claude → <em>login successful</em>.</li>
      <li>Para confirmar que funcionó, pedile: <em>listame mis agentes</em>.</li>
    </ol>
  </div>
</div>

Cuando estés conectado, andá a [Primeros pasos](primeros-pasos.md) para aprender el ritmo — o saltá directo a [todos los casos de uso](index.md).

← Volver al [inicio de la wiki](index.md)