Servidor MCP que expone 79 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./mcp responde 401 siempre que falte la key, sin importar cómo esté desplegado el servidor.Cada herramienta mapea a un endpoint REST del CRM y está lista para usarse desde cualquier agente IA
Selecciona 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. Importar listas en lote y enriquecer datos automáticamente.
Crear oportunidades, mover deals entre etapas del pipeline y analizar tasas de conversión.
Consultar audiencias, segmentar contactos y obtener métricas de campañas multicanal.
Crear tickets, agregar comentarios y gestionar conversaciones omnicanal.
Gestionar portafolios de deuda, crear acuerdos de pago, registrar cobros y verificar compliance.
Resúmenes ejecutivos, métricas del pipeline, tendencias de contactos y dashboards en tiempo real.
Gestionar reservas de hoteles y restaurantes. Crear, consultar y administrar disponibilidad.
Iniciar llamadas automatizadas con inteligencia artificial y monitorear resultados con transcripciones.