# Conectar una IA a OBSFlow (MCP)

OBSFlow incluye un servidor **MCP** (Model Context Protocol) en el mismo ejecutable: `obsflow --mcp`. Con él, la IA que desarrolla o revisa un proyecto puede generar, validar, ejecutar, probar y guardar diagramas `.obsflow`, y abrirlos en la app para que una persona los recorra paso a paso.

## Herramientas que recibe la IA

| Herramienta | Qué hace |
|---|---|
| `obsflow_guia` | Especificación completa (formato, bloques, expresiones, auditoría). También como recurso `obsflow://guia`. |
| `obsflow_validar` | Revisa un programa (objeto JSON o archivo). |
| `obsflow_ejecutar` | Lo ejecuta con entradas; devuelve salida, error, variables y traza. Con `funcion`, ejecuta sólo esa función. |
| `obsflow_probar_casos` | Corre una tabla de casos (salida exacta, textos o estado) y dice cuáles pasan; también acepta `funcion`. |
| `obsflow_guardar` / `obsflow_leer` / `obsflow_listar` | Archivos `.obsflow` del proyecto. |
| `obsflow_pseudocodigo` / `obsflow_svg` | Pseudocódigo e imagen del diagrama. |
| `obsflow_abrir` | Abre el diagrama en la app. |

También expone dos *prompts*: **auditar** (objetivo) y **diagramar** (descripción), y el esquema en `obsflow://esquema`.

**Seguridad:** sólo lee y escribe dentro de la carpeta del proyecto donde el cliente lo lanza (o la indicada en `OBSFLOW_RAIZ`). No hace llamadas de red.

## Claude Code

Para todos tus proyectos:

```bash
./instalar-mcp.sh          # equivale a: claude mcp add obsflow --scope user -- <ruta>/obsflow --mcp
```

Sólo para un proyecto: un archivo `.mcp.json` en la raíz del proyecto:

```json
{ "mcpServers": { "obsflow": { "type": "stdio", "command": "<ruta>/OBSFlow.app/Contents/MacOS/obsflow", "args": ["--mcp"] } } }
```

La primera vez que abras `claude` en ese proyecto te pedirá aprobar el servidor (es una medida de seguridad: un repositorio no puede aprobarse solo). En modo no interactivo se puede pasar explícitamente: `claude -p "…" --mcp-config .mcp.json`.

## Otros clientes

Claude Desktop (`~/Library/Application Support/Claude/claude_desktop_config.json`), Cursor (`.cursor/mcp.json`), VS Code (`.vscode/mcp.json`, clave `servers`), Windsurf y similares usan la misma forma:

```json
{ "mcpServers": { "obsflow": { "command": "<ruta>/obsflow", "args": ["--mcp"] } } }
```

Codex CLI (`~/.codex/config.toml`):

```toml
[mcp_servers.obsflow]
command = "<ruta>/obsflow"
args = ["--mcp"]
```

Rutas del ejecutable: Mac `…/OBSFlow.app/Contents/MacOS/obsflow`; Windows `C:\Program Files\OBSFlow\obsflow.exe`.

En **Windows**, el instalador ofrece la opción «Conectar con Claude Code (MCP)», y el menú Inicio → OBSFlow → «Conectar con IA (MCP)» hace lo mismo después (muestra también la configuración para otros clientes). Al desinstalar se quita la conexión.

## Comprobar la conexión

```bash
python3 prueba-dev/herramientas/probar_mcp.py   # cliente MCP mínimo: inicializa, lista y prueba herramientas
claude mcp list                                  # debe decir: obsflow … ✔ Connected
```

## Indicaciones para la IA del proyecto

Pon en el `CLAUDE.md` / `AGENTS.md` del proyecto algo como:

> Usa el servidor MCP **obsflow** para todo diagrama de flujo y para auditar código. Lee primero `obsflow_guia`. Guarda los diagramas en `diagramas/`, pruébalos con `obsflow_probar_casos` (caso feliz, cada error y límites) y marca cada diferencia contra la especificación con un `comment` `HALLAZGO:`.
