# Servidor MCP y CLI para el CRM de Attio (/es/docs/attio)

Sabe en qué punto está cada negociación sin abrir Attio. `attio` da al agente de IA que ya usas, como Claude Code,
Codex o Claude Desktop, una copia de tus negociaciones de Attio en tu ordenador, así que responde desde esa copia,
también sin conexión. Busca personas y empresas en Attio cuando preguntas por ellas.

Pregunta qué negociaciones están atascadas en una etapa, qué se ganó o se perdió esta semana o cómo está hoy tu
embudo. El agente responde con la negociación, su importe, su empresa y su responsable. Necesitas un espacio de
trabajo de Attio y un administrador que pueda crear un token de acceso.

**En esta página:**

1. [Lo que obtienes](#what-you-get)
2. [Lo que un recién llegado no adivinaría](#things-a-newcomer-would-not-guess)
3. [Cómo se ve](#how-it-looks)
4. [Por qué attio](#why-attio)
5. [Qué puede hacer](#what-it-can-do)
6. [Cómo funciona](#how-it-works)
7. [Empieza en unos minutos](#start-in-a-few-minutes)
8. [Límites](#limits)
9. [Encuentra una guía para tu tarea](#find-a-guide-for-your-task)

## Lo que obtienes [#lo-que-obtienes]

- **La respuesta, no la búsqueda.** Pregunta por una negociación con tus propias palabras. El agente la encuentra con
  su etapa, su importe, su empresa y sus personas, leída de tu ordenador, sin ir haciendo clic por Attio.
- **Tu embudo de un vistazo.** Cuántas negociaciones hay en cada etapa, su suma por moneda, cuántas pasaron a la
  siguiente etapa y tu proporción de ganadas.
- **Qué cambió desde ayer.** Negociaciones creadas, movidas, ganadas y perdidas, como lista o como un resumen
  matutino corto.
- **Personas y empresas cuando las pides.** "¿Quién es Anna en Example LLC?" lee Attio en ese momento, con correos,
  teléfonos y la empresa.
- **Una exportación de negociaciones en una línea.** Cualquier lista de negociaciones, personas o empresas se
  convierte en un archivo CSV para una hoja de cálculo.
- **Tu CRM junto a tus chats.** Una sola búsqueda encuentra una negociación junto a los mensajes, el correo y las
  reuniones sobre ella que las otras herramientas de WireCat guardan en tu ordenador.

## Lo que un recién llegado no adivinaría [#lo-que-un-recién-llegado-no-adivinaría]

- **Un token de acceso es tu llave.** Attio deja entrar a un programa con un token que crea un administrador del
  espacio de trabajo en Workspace settings → Developers. Lee todo el espacio de trabajo, no solo tus propios
  registros. [Instala](/llms.mdx/docs/es/attio/installation/content.md) muestra dónde hacer clic y qué ámbitos marcar.
- **`work` es un nombre que eliges tú.** Nombra un espacio de trabajo de Attio, y es la primera palabra de cada
  comando. Ningún comando elige un espacio de trabajo por ti.
- **Los comandos de negociaciones leen una copia, los de personas leen Attio.** `sync` copia las negociaciones del
  espacio de trabajo y las personas y empresas que nombran, con las etapas del embudo de negociaciones. `deals`, `pipelines` y
  `changes` responden desde esa copia. `people`, `organizations` y `users` preguntan a Attio cada vez, así que siempre
  muestran los datos más nuevos y necesitan internet.
- **Los comandos de negociaciones solo leen, el grupo `api` puede escribir.** `deals`, `people` y los demás comandos
  del CRM nunca cambian Attio. `attio work api …` llega a cada operación de la API de Attio, escrituras y borrados
  incluidos, hasta donde lo permiten los ámbitos del token y tus [permisos](/llms.mdx/docs/es/attio/permissions/content.md).
- **Por MCP, "ask" sigue adelante.** MCP es la forma en que aplicaciones como Claude Desktop llaman a una herramienta,
  y ahí nadie está en una terminal para responder a una pregunta. Bloquea el grupo `api` antes de conectar una
  aplicación así: [MCP](/llms.mdx/docs/es/attio/mcp/content.md).

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

```text
You:    Which deals are in Negotiation?
Agent:  (runs attio work deals list stage:Negotiation status:open)
        · "Example LLC renewal", 24 000 USD, owner Anna Example
        · "Sample Inc pilot", 6 500 USD, owner Bob Sample
You:    What did we win this week?
Agent:  (runs attio work changes list change:won "at>=7d")
        One deal: "Example Corp expansion", 12 000 USD, won on Tuesday.
```

*Negociaciones inventadas, salida de ejemplo.*

## Por qué attio [#por-qué-attio]

- **Una copia de tus negociaciones en tu ordenador.** Las listas, el tablero del embudo y la búsqueda responden desde
  ella sin ninguna petición a Attio, también sin conexión.
- **Seguro para dárselo a un agente.** Los comandos del CRM solo leen. Cada comando y cada operación de la API de Attio
  tiene su propio permiso: permitir, preguntar, solo lectura o rechazar. Una línea aleja toda escritura de un agente.
- **El token se queda en el llavero del sistema.** Nunca aparece en la salida, los errores ni los registros.
- **Respetuoso con Attio.** La mayoría de las respuestas no necesitan ninguna petición, así que el límite de
  peticiones de tu espacio de trabajo queda para tus otras aplicaciones.
- **Listo para cualquier agente.** Una skill para agentes con terminal, un servidor MCP para Claude Desktop y Cursor, y
  un enlace seguro para ChatGPT y Claude en el navegador.
- **Gratis y de código abierto.** Apache 2.0.

## Qué puede hacer [#qué-puede-hacer]

- **Negociaciones:** listarlas por etapa, estado o empresa, mostrar una con sus personas y su empresa, exportar una
  página a CSV. [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#deals)
- **El embudo:** cada etapa del embudo de negociaciones de Attio con su número y su suma, y la proporción de ganadas
  en el periodo que elijas. [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#the-pipeline)
- **Qué cambió:** negociaciones creadas, movidas, ganadas y perdidas, y un resumen matutino.
  [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#what-changed)
- **Personas, empresas y miembros:** buscar en Attio por nombre o correo, mostrar uno, exportar una lista.
  [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#people-companies-and-members)
- **Tus atributos propios:** los atributos personalizados del espacio de trabajo en negociaciones, personas y
  empresas, con sus valores. [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#your-own-attributes)
- **Búsqueda en todas tus herramientas:** negociaciones junto a mensajes, notas, eventos y reuniones de otras
  herramientas de WireCat. [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#search-everything)
- **Cualquier operación de la API de Attio** desde una terminal, con las mismas comprobaciones de permisos.
  [Úsalo](/llms.mdx/docs/es/attio/usage/content.md#the-attio-api)

## Cómo funciona [#cómo-funciona]

- **Una copia en tu ordenador.** `sync` pone tus negociaciones, y las personas y empresas que aparecen en ellas, en el
  almacén local de WireCat, el único archivo de tu ordenador que comparten todas las herramientas de WireCat. Las
  listas, el embudo y la búsqueda lo leen, también sin conexión.
- **Inicio de sesión con un token de acceso.** Se guarda en el llavero del sistema, o en un archivo privado en un
  ordenador sin llavero.
- **Hecho para scripts y agentes.** `--json` da una respuesta en JSON, y un error llega con un código para decidir qué
  hacer. [MCP](/llms.mdx/docs/es/attio/mcp/content.md)
- **Qué se guarda y qué va por la red.** [Seguridad](/llms.mdx/docs/es/attio/security/content.md)

## Empieza en unos minutos [#empieza-en-unos-minutos]

En WireCat Desktop, añade Attio desde la lista de herramientas y pega el token cuando te lo pida. O pega esto en tu
agente:

```text prompt
Instala attio con npm install -g @wirecat/attio-cli. Ayúdame a crear un token de acceso de Attio y a ejecutar attio work session start para conectar mi espacio de trabajo, y luego sincroniza y muéstrame mis negociaciones abiertas.
```

O en una terminal:

```sh
npm install -g @wirecat/attio-cli
attio skill install          # teaches Claude Code, Codex and Gemini CLI to use attio
attio work session start     # paste the Attio access token when it asks
attio work sync              # copy your deals and their people and companies
attio work deals list status:open
```

Necesitas Node.js 22.16 o un 22.x posterior, o Node.js 24 o posterior. [Instala](/llms.mdx/docs/es/attio/installation/content.md) muestra cómo
crear el token.

## Límites [#límites]

- Los comandos de negociaciones leen las negociaciones y nunca las cambian. Mover o cerrar una negociación está en las
  [próximas mejoras](/llms.mdx/docs/es/attio/roadmap/content.md).
- Las notas, las tareas, las listas y los objetos personalizados todavía no tienen comandos propios. `attio work api`
  llega a ellos.
- Las personas, las empresas y los miembros del espacio de trabajo se leen de Attio cada vez, así que necesitan
  internet.
- Attio no puede listar solo lo que cambió desde un momento dado, así que cada sincronización vuelve a listar todas
  las negociaciones. Un espacio de trabajo grande tarda más en sincronizarse.
- Solo un administrador del espacio de trabajo puede crear el token, y el token lee todo el espacio de trabajo.

## Encuentra una guía para tu tarea [#encuentra-una-guía-para-tu-tarea]

| Tarea | Guía |
|---|---|
| Instalar y conectar un espacio de trabajo | [Instala](/llms.mdx/docs/es/attio/installation/content.md) |
| Leer negociaciones, el embudo, qué cambió | [Úsalo](/llms.mdx/docs/es/attio/usage/content.md) |
| Conectar una aplicación que usa MCP | [MCP](/llms.mdx/docs/es/attio/mcp/content.md) |
| Decidir qué puede cambiar un agente | [Permisos](/llms.mdx/docs/es/attio/permissions/content.md) |
| Un comando o una opción exactos | [Comandos](/llms.mdx/docs/es/attio/commands/content.md) |
| Cambiar un ajuste | [Ajustes](/llms.mdx/docs/es/attio/configuration/content.md) |
| Algo no funciona | [Cuando algo falla](/llms.mdx/docs/es/attio/troubleshooting/content.md) |
| Qué se guarda y qué se envía | [Seguridad](/llms.mdx/docs/es/attio/security/content.md) |
| Qué viene después | [Próximas mejoras](/llms.mdx/docs/es/attio/roadmap/content.md) |
