Cómo conectar Freshsales a Microsoft Copilot 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Freshsales.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

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