Servidor MCP que expone 96 herramientas de la API de Pine CRM para que cualquier agente de IA pueda gestionar contactos, ventas, marketing, soporte, cobranza y más.
Un único endpoint para conectar cualquier cliente MCP compatible
POSThttps://mcp.pine.lat/mcp
Requiere tu API Key en cada petición: X-API-Key: sk_live_.... Sin ella el servidor responde 401. Ver autenticación
El servidor es multi-tenant: la key define a qué CRM entras, así que viaja en cada petición y nunca se configura en el servidor. Elige uno de estos tres métodos.
X-API-KeyLa mejor opción para clientes programáticos: SDK de Python o Node, curl, backends propios. Es también el único método que acepta la API REST de Pine.
Authorization: BearerPara clientes MCP estándar que ya traen un campo de token. Funciona solo contra este servidor MCP, no contra la API REST.
?apiKey=Úsalo solo si tu cliente no permite enviar headers. La URL completa queda escrita en los logs de acceso del proxy y en el archivo de configuración del cliente.
?apiKey=, considera esa key expuesta: quedó en logs de acceso, en el historial de tu shell y en la config de tu cliente MCP. Revócala y crea una nueva en cuanto puedas migrar a header.
sk_live_ y solo se muestra completa una vez.X-API-Key. Si además de este MCP llamas directo a pine.lat/api/external/v1/..., ahí Authorization: Bearer no funciona: es exclusivo del MCP.deals:read o whatsapp:send); sin él, la API responde 403. Con la key de los agentes IA de Pine, las lecturas de un cliente exigen el contacto de la conversación y la información del equipo (journeys, campañas) no se entrega./mcp responde 401 siempre que falte la key, sin importar cómo esté desplegado el servidor.Cada herramienta llama a la API REST de Pine con tu key y solo hace lo que el scope de esa key permite. Los parámetros con * son opcionales.
contacts:readcontacts:writecontacts:readcontacts:writecontacts:writecontacts:writecontacts:readcompanies:readcompanies:writecompanies:readcompanies:writedeals:readdeals:writedeals:readdeals:writedeals:writedeals:readdeals:readproducts:readproducts:readproducts:readquotations:readquotations:readorders:readorders:readorders:writeorders:readorders:writeorders:writeorders:writecampaigns:readcampaigns:read + contacts:readcampaigns:writecampaigns:write + contacts:readcampaigns:writecampaigns:writecampaigns:writecampaigns:readcampaigns:readcampaigns:readcampaigns:readcampaigns:readcampaigns:readevents:readevents:readevents:writesurveys:readsurveys:readsurveys:writetickets:readtickets:writetickets:readtickets:writeconversations:readconversations:readconversations:readvoice-ai:readanalytics:readanalytics:readanalytics:readcollection:readcollection:writecollection:readcollection:writecollection:readcollection:writecollection:readcollection:writecollection:readcollection:readcollection:writecollection:writecollection:readcollection:writecollection:readcollection:writecollection:writecollection:writecollection:readcollection:writehotels:readhotels:readhotels:readhotels:writehotels:readrestaurants:readrestaurants:readrestaurants:writerestaurants:readotp:writeotp:writeotp:readappointments:writewhatsapp:read o whatsapp:sendwhatsapp:sendwhatsapp:sendSelecciona tu cliente MCP y sigue las instrucciones para conectarte en minutos
Conecta Pine CRM a Claude Desktop usando mcp-remote
Crea tu API Key en pine.lat/developers/api-keys y cópiala (empieza por sk_live_).
Abre el archivo de configuración de Claude Desktop:
%APPDATA%\Claude\claude_desktop_config.jsonAgrega la configuración del servidor MCP con tu API Key:
{
"mcpServers": {
"pine-crm": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.pine.lat/mcp",
"--header",
"X-API-Key:sk_live_tu_api_key"
]
}
}
}Sin espacio después de los dos puntos: Claude Desktop parte los argumentos por espacios y perdería la key.
Reinicia Claude Desktop. Los tools de Pine CRM aparecerán automáticamente.
Conecta Pine CRM directamente desde la terminal
Crea tu API Key en pine.lat/developers/api-keys.
Agrega el servidor con tu credencial en el header:
$ claude mcp add --transport http pine-crm https://mcp.pine.lat/mcp \
--header "X-API-Key: sk_live_tu_api_key"O agrega a tu archivo .mcp.json en la raíz del proyecto:
{
"mcpServers": {
"pine-crm": {
"type": "http",
"url": "https://mcp.pine.lat/mcp",
"headers": {
"X-API-Key": "sk_live_tu_api_key"
}
}
}
}Claude Code detectará automáticamente los tools disponibles.
Conecta Pine CRM al IDE Cursor
Crea tu API Key en pine.lat/developers/api-keys.
Abre Settings → MCP Servers → Add new MCP Server y selecciona tipo HTTP
Ingresa la URL y el header de autenticación. Si prefieres editar el archivo, es ~/.cursor/mcp.json:
{
"mcpServers": {
"pine-crm": {
"url": "https://mcp.pine.lat/mcp",
"headers": {
"X-API-Key": "sk_live_tu_api_key"
}
}
}
}Guarda y los tools estarán disponibles en el chat de Cursor.
Conecta Pine CRM al IDE Windsurf (Codeium)
Crea tu API Key en pine.lat/developers/api-keys.
Abre Settings → MCP → Add server y selecciona HTTP Streamable
Ingresa la URL y el header. En archivo es ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"pine-crm": {
"serverUrl": "https://mcp.pine.lat/mcp",
"headers": {
"X-API-Key": "sk_live_tu_api_key"
}
}
}
}Activa el servidor. Los tools aparecerán en Cascade.
Conecta desde cualquier aplicación Python
Instala el SDK de MCP:
$ pip install mcpConéctate al servidor de Pine CRM enviando tu API Key en el header:
import os
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client
# La key se lee del entorno: no la dejes escrita en el código.
async with streamablehttp_client(
"https://mcp.pine.lat/mcp",
headers={"X-API-Key": os.environ["PINE_CRM_API_KEY"]},
) as (read, write, _):
async with ClientSession(read, write) as session:
await session.initialize()
tools = await session.list_tools()
print(f"Tools: {len(tools.tools)}")Conecta desde cualquier aplicación Node.js/TypeScript
Instala el SDK de MCP:
$ npm install @modelcontextprotocol/sdkConéctate al servidor de Pine CRM enviando tu API Key en el header:
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport }
from "@modelcontextprotocol/sdk/client/streamableHttp.js";
const client = new Client({ name: "my-app", version: "1.0.0" });
// La key se lee del entorno: no la dejes escrita en el código.
const transport = new StreamableHTTPClientTransport(
new URL("https://mcp.pine.lat/mcp"),
{ requestInit: { headers: { "X-API-Key": process.env.PINE_CRM_API_KEY } } }
);
await client.connect(transport);
const tools = await client.listTools();
console.log(`Tools: ${tools.tools.length}`);Esquemas y datos de referencia que el agente IA puede consultar para entender el modelo de datos
Ejemplos de flujos completos que un agente IA puede ejecutar con Pine CRM
Buscar, crear y actualizar contactos y empresas, cargar listas en lote y llenar sus campos personalizados con los códigos reales de la cuenta.
Crear oportunidades en el pipeline y la etapa correctos, moverlas, consultar catálogo y cotizaciones, registrar pedidos y pagos, y medir ventas y tasa de cierre.
Armar y dividir audiencias, revisar campañas y journeys con sus métricas de entrega, y ver quién está en cada automatización.
Crear y comentar tickets, leer conversaciones completas del inbox y responder por WhatsApp dentro de las reglas del canal.
Gestionar portafolios de deuda, crear acuerdos de pago, registrar cobros y verificar compliance.
Resúmenes ejecutivos, métricas del pipeline y tendencias de contactos por periodo (7, 30 o 90 días), diciendo qué cifra es del periodo y cuál histórica.
Consultar hoteles, restaurantes y disponibilidad con precio, y crear o revisar reservas.
Leer el contexto de una llamada de Voice AI (contacto, campaña e instrucciones). Las llamadas se lanzan desde campañas o journeys de Pine.