# Conecta tu asistente de IA (MCP) (/es/docs/mcp)

> Conecta Claude, Claude Code, Cursor, Codex o ChatGPT a Loomaly. Doce herramientas cubren rankings, búsqueda con IA, correcciones e informes.

Loomaly es un servidor MCP en `https://loomaly.com/mcp` (plugin **2.2.0**, MCP **2.0**). Conecta un asistente una vez; a partir de ahí trabajas en el chat. Loomaly nunca cambia tu sitio.

La cuenta, la facturación, Google y los asistentes viven en [`/account`](https://loomaly.com/account).

## Cómo se ve cada respuesta [#cómo-se-ve-cada-respuesta]

| Campo | Significado |
| --- | --- |
| `say` | Respuesta en lenguaje claro. |
| `next` | Siguiente llamada a herramienta, o null. |
| `errors` | Recuperables: `{ error, say, recover }`. |
| `handoff` | Paso solo humano hacia `/account/...`. |

## Conectar [#conectar]

<Tabs items={['Claude Code', 'Cursor', 'Codex', 'Claude web y escritorio', 'ChatGPT', 'Otros']}>
<Tab value="Claude Code">

```bash
claude mcp add --transport http loomaly https://loomaly.com/mcp
```

Luego `/mcp` → **loomaly** → iniciar sesión.

</Tab>
<Tab value="Cursor">

[Add to Cursor](https://cursor.com/en/install-mcp?name=loomaly&config=eyJ1cmwiOiJodHRwczovL2xvb21hbHkuY29tL21jcCJ9) o añade a `mcp.json`:

```json
{ "mcpServers": { "loomaly": { "url": "https://loomaly.com/mcp" } } }
```

</Tab>
<Tab value="Codex">

```bash
codex mcp add loomaly --url https://loomaly.com/mcp
```

</Tab>
<Tab value="Claude web y escritorio">

[Directorio de Claude](https://claude.ai/directory/loomaly) o **Customize → Connectors**. En Team/Enterprise puede hacer falta el admin.

</Tab>
<Tab value="ChatGPT">

En ChatGPT **Business**, **Enterprise** o **Edu**, añade el conector MCP con URL `https://loomaly.com/mcp` (o instálalo desde el directorio de la org) e inicia sesión cuando se abra el navegador.

</Tab>
<Tab value="Otros">

MCP remoto por Streamable HTTP + OAuth. Solo la URL `https://loomaly.com/mcp`.

</Tab>
</Tabs>

## Permisos [#permisos]

`findings:read` → status, todo, problem, focus, visibility, report.  
`findings:write` → triage, set_goals, send_to_dev.  
`audit:run` → add_site, check.  
`gsc:read` / `gsc:write` → visibility google / google.

Gestiona conexiones en [`/account/agents`](https://loomaly.com/account/agents).

## Las doce herramientas [#las-doce-herramientas]

`status`, `add_site`, `todo`, `problem`, `triage`, `send_to_dev`, `check`, `visibility`, `focus`, `set_goals`, `google`, `report`.

Bucle típico: `status` → `add_site` si hace falta → `todo` (el ítem superior ya trae `fixPrompt`) → arreglar / `send_to_dev` → abrir PR → `check` (`target: fix`, `ref` = URL del PR). Loomaly espera el deploy y recomprueba solo. `problem` es opcional. `triage` solo: ignore / restore / decide_link.

Datos de pago: `set_goals` → `visibility` (leer) → `check` sin `maxCost` (estimar) → con `maxCost` (gastar). Free = $0.

```text
Usa Loomaly para revisar example.com. Corrige el problema prioritario en este repo, abre un PR y haz check con target fix y la URL del PR como ref.
```