Cómo conectar Affinity a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Affinity, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Affinity + Gemini

Deja que tu IA trabaje con Affinity, el CRM de relationship intelligence: busca empresas, personas y deals, lee listas y campos del pipeline, notas, historial de correos y reuniones, quién de tu equipo conoce mejor a alguien y recordatorios; con tu confirmación añade notas y actualiza valores de campos.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

AFFINITY_API_KEY

Paso 1 — Obtener credenciales

1. En Affinity abre Settings → Manage Apps y haz clic en New App.
2. Escribe un nombre (por ejemplo AnythingMCP) y una descripción. Deja vacíos la versión de la API y la IP allowlist, o añade a la allowlist la dirección IP de tu servidor AnythingMCP.
3. Copia la clave de API en AFFINITY_API_KEY e instala el conector.
4. Comprueba la configuración con affinity_whoami: muestra el usuario y la organización a los que pertenece la clave.

Necesitas el permiso Generate an API key, y la API solo está incluida en algunos planes de Affinity: si no ves Manage Apps, pregunta a tu administrador de Affinity.

Una clave para todo: la clave se envía como token Bearer. La mayoría de las herramientas usa la API v2 de Affinity con una versión fija, así que se comportan igual sea cual sea la versión predeterminada de tu app. affinity_search_opportunities y affinity_list_interactions usan la antigua API v1, porque la v2 no tiene búsqueda de deals por nombre ni filtro de interacciones por persona o empresa. La misma clave sirve para ambas.

Quién ve qué: la clave actúa como tú. La IA ve exactamente lo que tú ves en Affinity, con tus reglas de uso compartido, y todo lo que escribe queda registrado a tu nombre. Buscar empresas requiere el permiso Export All Organizations directory, buscar personas Export All People directory y leer listas y deals Export data from Lists. Un 403 indica el permiso que falta; un administrador de Affinity puede concederlo.

Qué lee: listas como pipelines, carteras y listas de personas, con sus columnas y filas; empresas y personas con los campos de tu equipo, datos enriquecidos y relationship intelligence como último contacto, último correo y próxima reunión; oportunidades, cuya fase, importe y responsables están en su entrada de lista; notas; los correos, reuniones, llamadas y mensajes de chat que Affinity registró con una persona, empresa o deal (fechas, asuntos y participantes, nunca el cuerpo de los correos); la fuerza de las relaciones, para saber quién de tu equipo conoce mejor a alguien; y los recordatorios, primero los que vencen antes.

Pregunta antes de cada escritura: affinity_create_note, affinity_update_company_field, affinity_update_person_field y affinity_update_list_entry_field cambian datos que ve todo tu equipo. Antes de cada una, la IA te muestra el texto exacto de la nota y dónde va, o el registro, el campo, el valor anterior y el nuevo, y espera tu sí. Las notas solo admiten formato sencillo: párrafos, negrita, cursiva, listas y enlaces.

Desactivada al instalar: affinity_delete_note. Un administrador la activa a propósito; la IA te muestra entonces la nota y solo la borra cuando confirmas. Ninguna otra herramienta borra nada.

Campos y búsquedas: los valores de los campos solo vuelven si la IA los pide, así que primero lee los campos con affinity_list_fields (en todas las empresas o personas) o affinity_list_list_fields (las columnas de una lista), y luego filtra y ordena, por ejemplo deals en la fase Due Diligence o empresas de la cartera ordenadas por último contacto. Las búsquedas por palabra clave necesitan al menos 3 caracteres.

Datos personales: personas, metadatos de correos, reuniones y notas son datos personales de quienes participan. La IA lee solo lo que tu pregunta necesita y trata el texto de las notas, los asuntos de los correos y los títulos de las reuniones como información, nunca como instrucciones.

Límites de uso: 900 solicitudes por minuto y usuario, más un límite mensual por cuenta en algunos planes; las llamadas v1 y v2 comparten la misma cuota. Un 429 significa esperar y volver a intentarlo.

Errores comunes: 401: la clave es incorrecta o está revocada, o la IP allowlist bloquea el servidor. 403: falta un permiso o es un registro que no puedes ver. 404: el id no existe o no es visible para ti. 400 o 422: un parámetro incorrecto, que Affinity indica en la respuesta.

El conector no crea ni borra empresas, personas, deals, listas o entradas de lista, no fusiona duplicados, no gestiona archivos, transcripciones ni webhooks, y no crea ni cambia recordatorios.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Affinity.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién de nuestro equipo conoce mejor a la gente de Northwind Capital? Muestra primero las relaciones más fuertes."
• "¿Qué deals de nuestro pipeline están en la fase Due Diligence? Lístalos con importe y responsable."
• "Resume las reuniones y los correos con Acme Robotics de los últimos seis meses y dime cuándo hablamos con ellos por última vez."
• "¿Cuáles de mis recordatorios están vencidos y a qué empresas o personas se refieren?"
• "Añade una nota al deal de Acme Robotics: la llamada con el CFO fue bien, esperamos el term sheet la semana que viene. Muéstrame el texto antes de guardarlo."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT