Cómo conectar Freshsales a Cursor vía MCP

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

Freshsales + Cursor

Freshsales (Freshworks CRM) desde cualquier agente de IA: busca y filtra contactos, cuentas y oportunidades, mueve oportunidades entre las etapas del pipeline, añade notas, planifica tareas y citas, registra actividades de ventas y gestiona listas de marketing. Funciona con la clave API personal de un usuario y la URL bundle de tu cuenta.

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:

FRESHSALES_BUNDLE_URL, FRESHSALES_API_KEY

Paso 1 — Obtener credenciales

La configuración lleva unos 2 minutos. Necesitas una cuenta de Freshsales (Freshworks CRM).

1. En Freshsales haz clic en tu foto de perfil, luego en Profile Settings, y abre la pestaña API Settings.
2. Copia Your API key en FRESHSALES_API_KEY. El conector la envía como Authorization: Token token=<key>, así que pega solo la clave.
3. En la misma pestaña copia el bundle alias (la dirección de tu cuenta) en FRESHSALES_BUNDLE_URL, por ejemplo https://acme.myfreshworks.com/crm/sales. Las cuentas creadas antes de la suite Freshworks usan https://acme.freshsales.io. Omite /api y la barra final.
4. Instala el conector y ejecuta freshsales_list_owners: lista los usuarios del portal y confirma clave y dirección.

Cada llamada actúa con los permisos del usuario cuya clave has puesto: los registros fuera de su alcance no se ven. Usa la clave de un usuario que vea los datos que necesita el equipo.

Por dónde empezar: freshsales_list_owners da los ids de usuario para owner_id. freshsales_list_selector lee una lista de selección (territorios, pipelines y etapas, monedas, tipos y motivos de oportunidad, fuentes de leads, sectores y tipos de empresa, campañas, estados de contacto, etapas del ciclo de vida, tipos y resultados de actividades de ventas) y devuelve los ids que se usan al escribir. freshsales_list_pipeline_stages da las etapas de un pipeline. freshsales_list_fields lista los campos de contactos, cuentas, oportunidades o actividades de ventas, también los personalizados: sus nombres internos empiezan por cf_ y van en custom_field.

Encontrar registros:

• freshsales_search: búsqueda de texto por nombre o email en contactos, cuentas, oportunidades y usuarios. include acepta los nombres en singular contact, sales_account, deal y user; en plural no devuelve nada.
• freshsales_lookup: coincidencia exacta en un campo, por ejemplo contactos por email, o contactos, cuentas y oportunidades por nombre o por el valor de un campo personalizado.
• freshsales_filtered_search: reglas sobre campos (valores exactos, rangos, listas), devuelve registros completos.
• Los listados siempre pasan por una vista guardada: freshsales_list_views da los ids de las vistas (por ejemplo "All Contacts" o "My Deals") y luego freshsales_list_contacts, freshsales_list_accounts o freshsales_list_deals leen la vista con ordenación.

Contactos, cuentas y oportunidades: freshsales_get_contact, freshsales_get_account y freshsales_get_deal leen un registro e incrustan registros relacionados con include (por ejemplo sales_accounts,deals,notes). freshsales_list_contact_activities muestra la cronología de un contacto (emails, llamadas, notas, cambios de campos, visitas web). Para escribir, la IA usa freshsales_create_contact (al menos email o apellido), freshsales_update_contact, freshsales_upsert_contact (crea o actualiza por email u otro campo único), freshsales_create_account (name único), freshsales_update_account, freshsales_create_deal (name y amount obligatorios) y freshsales_update_deal. Una oportunidad avanza cuando deal_stage_id se pone en una etapa de su pipeline; ganada y perdida también son etapas, y una oportunidad perdida puede llevar un deal_reason_id. Las actualizaciones cambian solo los campos enviados.

Notas, tareas, citas y actividades se vinculan a un registro con targetable_type (Contact, SalesAccount o Deal) y targetable_id:

• Notas: freshsales_create_note, freshsales_update_note.
• Tareas: freshsales_list_tasks (un filtro por llamada: open, due_today, due_tomorrow, overdue o completed), freshsales_get_task, freshsales_create_task, freshsales_update_task, freshsales_complete_task.
• Citas: freshsales_list_appointments (open para las próximas, past para las pasadas; los portales antiguos usan upcoming), freshsales_get_appointment, freshsales_create_appointment, freshsales_update_appointment. Los asistentes son usuarios (FdMultitenant::User) o contactos (Contact).
• Actividades de ventas como llamadas y visitas registradas: freshsales_list_sales_activities, freshsales_get_sales_activity, freshsales_create_sales_activity.

Listas de marketing: freshsales_list_marketing_lists, freshsales_list_marketing_list_contacts, freshsales_add_contacts_to_list y freshsales_remove_contacts_from_list (los contactos se conservan).

Leads: las cuentas actuales de Freshsales guardan a los prospectos como contactos con una etapa del ciclo de vida; no hay un módulo de leads aparte. La IA filtra contactos por etapa del ciclo de vida con una vista o con freshsales_filtered_search.

Desactivadas al instalar: ninguna. El conector no tiene herramientas de borrado, así que no puede eliminar contactos, cuentas, oportunidades, notas, tareas ni citas. Crear y modificar registros cambia tu CRM real, así que pide a la IA que te muestre los campos antes de guardar.

Formatos de datos: las marcas de tiempo vuelven en UTC o con desfase (2026-02-13T23:27:49Z). Las fechas de entrada aceptan YYYY-MM-DD o ISO 8601; sin zona se asume UTC. Los importes están en la moneda de la oportunidad; base_currency_amount está convertido a la moneda del portal. Los campos vacíos son null. Los registros incrustados con include llegan en arrays separados de primer nivel (users, sales_accounts, deals) junto al registro, enlazados por id.

Paginación: los listados aceptan page (desde 1) y per_page (25 por defecto, como máximo 100) y devuelven meta.total_pages y meta.total. freshsales_search devuelve 10 resultados por defecto, como máximo 100.

Límites y errores habituales: 1000 peticiones por hora y cuenta; por encima Freshsales responde 429. 401 indica una clave errónea o ausente, 403 que el usuario no tiene el permiso o la función no está en el plan, 404 un id erróneo o una URL bundle equivocada. Los errores de validación vuelven como 400 con errors.message.

El conector no borra registros, no envía emails y no cambia ajustes del portal, campos ni pipelines.

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de Freshsales.

Herramientas disponibles

Ejemplos de prompts

• "Busca el contacto [email protected] y muéstrame sus oportunidades abiertas y las últimas notas de su ficha."
• "Lista mis oportunidades abiertas con cierre previsto este mes, con importe y etapa."
• "Pasa la oportunidad Renovación Acme a la etapa Negociación y añade una nota de que la oferta está enviada."
• "¿Qué tareas mías están vencidas? Agrúpalas por cuenta vinculada."
• "Registra para hoy una llamada de 30 minutos con Tom Becker y crea una tarea de seguimiento para el martes que viene a las 10:00."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot