# Conectarte

Ninjo funciona donde ya usás IA — la app o el navegador de **Claude**, **ChatGPT**, o **Claude Code**. Elegí tu herramienta abajo y vas a ver solo los pasos que te aplican. La mayoría queda conectada en unos dos minutos.

<div class="tabs" data-tabs>
  <div class="tab-btns">
    <button class="tab-btn on" data-tab="claude"><span class="ti">💬</span>Claude · app / navegador</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">Recomendado</span>
    <h4>Agregar el conector de Ninjo</h4>
    <p class="lead-note">Funciona igual en la app de escritorio de Claude (Mac o Windows) y en tu navegador en claude.ai. Vas a pegar una sola dirección:</p>
    <blockquote>https://cortex-gateway.ninjoaiplatform.com/mcp</blockquote>
    <ol>
      <li>Abrí <strong>Settings → Connectors</strong> y hacé clic en <strong>Add custom connector</strong>.</li>
      <li>Ponele de nombre <strong>Ninjo</strong> y pegá la dirección de arriba en <strong>Remote MCP server URL</strong>.</li>
      <li>Dejá los campos de OAuth en blanco (en <em>Advanced settings</em>) y hacé clic en <strong>Add</strong>.</li>
      <li>Cuando te lo pida, iniciá sesión con tu <strong>email y contraseña de Ninjo</strong>.</li>
      <li>En un chat, activá el conector <strong>Ninjo</strong> — el menú <strong>+</strong> → connectors → activalo.</li>
      <li>Pedile <em>"listame mis agentes"</em> para confirmar que quedaste conectado.</li>
    </ol>
    <aside class="callout">💳 <strong>Ojo:</strong> los conectores personalizados necesitan un plan pago de Claude (Pro, Max, Team o Enterprise). ¿No ves el botón <em>Add custom connector</em>? Estás en el plan gratis — usá la pestaña <strong>Claude Code · terminal</strong>, o preguntanos por la app web.</aside>
    <p class="lead-note">✅ Ese es todo el setup — el conector también carga el manual de juego de Ninjo automáticamente, así tu agente se arma como corresponde. ¿Querés ir más a fondo? La descarga opcional del proyecto de más abajo le da a Claude la referencia completa.</p>
  </div>
  <div class="tab-panel" data-panel="chatgpt">
    <h4>Agregar la app de Ninjo</h4>
    <p class="lead-note">Ninjo ahora es una <strong>app aprobada de ChatGPT</strong> — sin conector personalizado, sin pegar una URL, sin modo desarrollador. Simplemente la buscás.</p>
    <ol>
      <li>Abrí <strong>Settings → Apps &amp; Connectors</strong> (o el menú <strong>+</strong> / apps dentro de un chat).</li>
      <li><strong>Buscá "Ninjo"</strong> en el directorio de apps y abrila.</li>
      <li>Hacé clic en <strong>Connect</strong> y, cuando te lo pida, iniciá sesión con tu <strong>email y contraseña de Ninjo</strong>.</li>
      <li>En un chat, activá la app <strong>Ninjo</strong> y pedile <em>"listame mis agentes"</em> para confirmar.</li>
    </ol>
    <aside class="callout">💳 <strong>Ojo:</strong> las apps necesitan un plan pago de ChatGPT, y el directorio todavía se está habilitando. ¿Todavía no ves Ninjo? Escribinos y te dejamos conectado.</aside>
    <p class="lead-note">✅ La app también carga el manual de juego de Ninjo automáticamente. ¿Querés ir más a fondo? La descarga opcional del proyecto de más abajo le da a ChatGPT la referencia completa.</p>
  </div>
  <div class="tab-panel" data-panel="cc-term">
    <span class="pill easy">Lo más fácil para Claude Code</span>
    <h4>1 · Conseguir el proyecto</h4>
    <p class="lead-note">Claude Code trabaja desde los archivos en tu máquina, así que acá la descarga <strong>no es opcional</strong> — es la forma en que Claude Code obtiene las skills y el manual de juego de Ninjo.</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>Descargar el proyecto<span class="hint">.zip</span></a>
    <ol>
      <li>Hacé clic en el botón — se descarga al toque, sin cuenta ni inicio de sesión.</li>
      <li>Descomprimilo (doble clic en Mac, o clic derecho → <em>Extraer todo</em> en Windows).</li>
      <li>Abrí esa carpeta <code>cortex-ops</code> en Claude Code.</li>
    </ol>
    <h4>2 · Entrar</h4>
    <ol>
      <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="cc-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. Corre desde el repositorio conectado, así que acá no hay descarga.</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).

---

## El manual de juego — lo que hace a un agente *de verdad*

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í. El **manual de juego** es lo que le enseña a Claude a armar todo eso en vez de un prompt que suena lindo pero se pierde todo.

- **En Claude o ChatGPT** — buena noticia: el conector ahora entrega el manual de juego **automáticamente**, así obtenés un agente de verdad por defecto. Descargar el proyecto es un **extra opcional** — adjuntá el `.zip` dentro de un **Project** cuando quieras que Claude tenga la referencia más profunda posible (los agentes de ejemplo completos, las plantillas y la base de conocimiento) para un armado difícil.
- **En Claude Code** — los archivos del proyecto **son** el manual de juego: las skills, el manual de operación y los ejemplos viven todos en la carpeta que abrís. Por eso la descarga es un paso **obligatorio** en las pestañas de Claude Code de arriba, no un 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>Descargar el proyecto<span class="hint">.zip</span></a>

Si usás un **Project** (en Claude o ChatGPT), adjuntá el `.zip` **entero** — el archivo completo, no unas pocas páginas que elegiste a mano — y volvé a adjuntarlo cada vez que descargues una versión más nueva. Un Project lo mantiene a mano entre conversaciones.

---

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

---

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