# Construir con Claude o ChatGPT por MCP

> Cómo conectar Claude (camino principal) o ChatGPT al MCP de MINDO dentro de la cuenta del cliente o de tu sandbox, sumarle los docs como contexto y usar el kit del implementador para armar agentes.

La forma recomendada de construir un agente en MINDO es con **Claude** o **ChatGPT** conectados al servidor MCP de MINDO (`https://app.mindo.ar/mcp`). El asistente crea el agente, escribe el prompt, carga el conocimiento, arma las herramientas y los casos de prueba, y tú revisas y corriges. Hoy recomendamos solo estos dos asistentes; el camino principal es Claude.

## Video

<video controls className="w-full aspect-video rounded-xl" src="/videos/partners/construir-con-ia.mp4"></video>

## Qué necesitas

- Claude (claude.ai, Claude Desktop o Claude Code) o ChatGPT con modo desarrollador (Plus, Pro, Business, Enterprise o Edu).
- Una cuenta de MINDO en plan **Escala** para trabajar con agentes avanzados: la del cliente o tu **sandbox** (Escala, con créditos IA de cortesía). El MCP solo funciona desde el plan Crecimiento.
- El [kit del implementador](/partners/kit): las instrucciones del proyecto y la skill para Claude.

## 1. Entra a la cuenta correcta

La conexión MCP queda atada a la cuenta de MINDO que tienes abierta cuando autorizas. Por eso, **primero entra a la cuenta** y después conecta:

- **Cliente**: en el panel de partners, abre el cliente y toca **Entrar como administrador**.
- **Sandbox**: en **Certificación → Tu sandbox**, toca **Entrar al sandbox** (o **Crear mi sandbox** la primera vez).

En la pantalla de autorización de MINDO fíjate que diga el nombre de esa cuenta (por ejemplo, *Sandbox · Tu nombre*) antes de tocar **Permitir**.

<Warning>
  Cada cliente es una conexión distinta. Si trabajas con varios, ponle un nombre claro a cada conector (por ejemplo, `MINDO - Óptica Centro`) o desconecta y vuelve a conectar al cambiar de cliente. Así no le creas un agente al cliente equivocado.
</Warning>

## 2. Conecta el asistente

<CardGroup cols={2}>
  <Card title="Claude (recomendado)" icon="message-square" href="/guias/ia/claude">
    **Customize › Connectors › Add custom connector** con la URL `https://app.mindo.ar/mcp`.
  </Card>
  <Card title="ChatGPT" icon="message-circle" href="/guias/ia/chatgpt">
    **Settings › Apps**, modo desarrollador, **Create** con la misma URL y autenticación OAuth.
  </Card>
</CardGroup>

En Claude Code:

```bash
claude mcp add --transport http MINDO https://app.mindo.ar/mcp
```

Para verificar, pídele: *"Usando MINDO, dame el resumen de la cuenta"*. Tiene que responder con el nombre de la cuenta del cliente o del sandbox.

## 3. Suma los docs como contexto

El MCP le da al asistente las herramientas, pero no la metodología. Para que trabaje como esperamos, dale los docs:

- **Índice completo**: [docs.mindo.ar/llms.txt](https://docs.mindo.ar/llms.txt) lista todas las páginas con su descripción. Cada página está en Markdown agregando `.md` a la dirección, por ejemplo `https://docs.mindo.ar/partners/metodologia/pruebas.md`.
- **Desde cada página**: el menú de arriba de cada guía permite copiarla en Markdown o abrirla directamente en ChatGPT o en Claude.
- **En un proyecto**: crea un **Project** en Claude (o un GPT personalizado en ChatGPT) y súmale como conocimiento las páginas de la Metodología y de Agentes avanzados.

## 4. Carga el kit del implementador

El [kit](/partners/kit) tiene dos piezas:

- **Instrucciones del proyecto**: un texto para pegar en las instrucciones de un Project de Claude o de un GPT personalizado. Le enseña al asistente las fases, el canvas, las reglas de credenciales y los casos de prueba mínimos.
- **Skill para Claude**: el mismo método como skill (`SKILL.md`), para Claude Code o para subirla en claude.ai.

## 5. Trabaja por etapas

Con todo conectado, sigue el orden de la metodología y pídelo en mensajes cortos:

1. *"Lee el canvas y el flujo que te pego y propón el prompt del agente en secciones con #."*
2. *"Crea el agente en modo avanzado con ese prompt y suma como conocimiento la web del negocio."*
3. *"Crea una herramienta HTTP para consultar el stock en esta URL. La clave está en Ajustes › Credenciales como `api_stock`."*
4. *"Prueba la herramienta con un producto real y muéstrame la respuesta."*
5. *"Suma 8 casos de prueba: camino feliz, casos difíciles, derivación y fuera de alcance. Córrelos y muéstrame qué falló."*
6. Corrige el prompt, vuelve a correr y, cuando pasan, pide publicar. Publicar y activar **piden confirmación**: el asistente te muestra un resumen y solo lo hace cuando respondes que sí.

<Tip>
  Lee cada cosa que arma el asistente antes de seguir. En la certificación se evalúa justamente eso: el criterio **Criterio con la IA** mira si revisaste y corregiste lo que armó, no solo si le pediste cosas.
</Tip>

## El chat de las implementaciones

Además de armar agentes, el asistente lee y escribe en el chat de las implementaciones de tus clientes y les hace preguntas puntuales que quedan pendientes hasta que responden. Por ejemplo, después de una reunión: *"Con estas notas, arma las preguntas que le quedaron pendientes al cliente de Ópticas Norte"*. Mira [Implementaciones → El chat por MCP](/partners/implementaciones#el-chat-por-mcp).

## El catálogo compacto

El MCP de MINDO usa un catálogo compacto por defecto, compatible con Claude y Codex mediante herramientas MCP estándar. El asistente busca la acción que necesita y recibe solo sus instrucciones y parámetros. Así evita cargar todas las herramientas al empezar la conversación.

La URL sigue siendo `https://app.mindo.ar/mcp`. Si una integración necesita el catálogo completo, puede usar `https://app.mindo.ar/mcp?catalog=full`.

## El canvas y el flujo por MCP

El asistente también puede leer y editar **Implementaciones → Definición** de tus clientes. Por ejemplo: *"Con estas notas de la reunión, completa el canvas y arma el flujo esperado de Ópticas Norte"*.

En el catálogo compacto, el asistente descubre las acciones con `search_mindo_tools`, consulta con `read_mindo_tool` y guarda con `write_mindo_tool`. Las acciones conservan sus permisos y validaciones.

Primero usa `list_implementations` para encontrar la implementación y `get_implementation_definition` para leer el canvas, el flujo y su revisión. Para armar el diagrama, `get_implementation_flow_reference` le explica los tipos de pasos y trae un ejemplo con preguntas, decisiones, herramientas y derivación a una persona. Con `update_implementation_definition` puede cambiar secciones del canvas en texto plano o reemplazar el flujo completo. Las secciones omitidas conservan su contenido y formato. Si alguien editó la definición mientras tanto, debe volver a leerla antes de guardar.

Los cambios de contenido dejan pendiente una nueva aprobación del cliente. Guardar esta definición no modifica ni publica el agente; es el documento que acuerdan antes de construirlo.

## Lo que no hace el MCP (todavía)

- Las credenciales las carga una persona en **Ajustes › Credenciales**. Nunca las pegues en el chat con el asistente.

## Checklist

- [ ] Entré a la cuenta del cliente o al sandbox antes de autorizar.
- [ ] La pantalla de autorización mostraba la cuenta correcta.
- [ ] El asistente responde con el resumen de esa cuenta.
- [ ] Cargué las instrucciones del kit o la skill.
- [ ] El asistente tiene acceso a los docs (llms.txt o un Project con las páginas).
- [ ] Guardo el link de la conversación (en el examen se entrega).
