salesforce-einstein-mcp-server-por-cdata

Servidor de protocolo de contexto de modelo (MCP) de CData para Salesforce Einstein

:heavy_exclamation_mark: Este proyecto crea un servidor MCP de sólo lectura. Para funciones completas de lectura, escritura, actualización, eliminación y acción y una configuración simplificada, consulte nuestro servidor MCP gratuito de CData para Salesforce Einstein (beta).

Propósito

Hemos creado este servidor MCP de sólo lectura para permitir que los LLM (como Claude Desktop) consulten datos en directo de Salesforce Einstein con el controlador CData JDBC para Salesforce Einstein.

El controlador CData JDBC se conecta a Salesforce Einstein exponiéndolos como modelos SQL relacionales.

Este servidor envuelve ese controlador y hace que los datos de Salesforce Einstein estén disponibles a través de una sencilla interfaz MCP, de modo que los LLM puedan recuperar información en tiempo real haciendo preguntas en lenguaje natural, sin necesidad de SQL.

Guía de instalación

1. Clone el repositorio:

   git clone https://github.com/cdatasoftware/salesforce-einstein-mcp-server-by-cdata.git cd salesforce-einstein-mcp-server-by-cdata

2. Cree el servidor:

   mvn clean install

   Esto crea el archivo JAR: CDataMCP-jar-con-dependencias.jar
3. Descargue e instale el CData JDBC Driver para {source}: https://www.cdata.com/drivers/einstein/download/jdbc
4. Licenciar el CData JDBC Driver
   • Navegue a la carpeta lib en el directorio de instalación, típicamente
     • (Windows) C:Archivos de programa\CData\CData JDBC Driver for Salesforce Einstein\
     • (Mac/Linux) /Aplicaciones/CData JDBC Driver for Salesforce Einstein/
   • Ejecute el comando java -jar cdata.jdbc..jar --license
   • Introduzca su nombre, correo electrónico y "TRIAL" (o su clave de licencia).
5. Configure su conexión a la fuente de datos (Salesforce como ejemplo)

   • Ejecute el comando java -jar cdata.jdbc..jar para abrir la utilidad de cadena de conexión.

   • Configure la cadena de conexión y haga clic en "Probar conexión"

     Nota: Si las fuentes de datos utilizan OAuth, tendrá que autenticarse en su navegador.

   • Una vez autenticado, copie la cadena de conexión para utilizarla más tarde.

6. Cree un archivo .prp para su conexión JDBC (por ejemplo, salesforce-einstein.prp) utilizando las siguientes propiedades y formato
   • Prefix - un prefijo a utilizar para las herramientas expuestas
   • ServerName - un nombre para su servidor
   • ServerVersion - una versión para su servidor
   • DriverPath - la ruta completa al archivo JAR de su controlador JDBC
   • DriverClass - el nombre de la clase del driver JDBC (ej. cdata.jdbc..Driver)
   • JdbcUrl - la cadena de conexión JDBC a utilizar con el Driver CData JDBC para conectarse a sus datos (copiado de arriba)
   • Tables - déjelo en blanco para acceder a todos los datos, de lo contrario puede declarar explícitamente las tablas para las que desea crear acceso

     Prefix= ServerName=CData ServerVersion=1.0 DriverPath=PATH\TO\cdata.jdbc..jar DriverClass=cdata.jdbc..Driver JdbcUrl=jdbc::InitiateOAuth=GETANDREFRESH; Tables=

Uso del servidor con Claude Desktop

1. Cree el archivo de configuración para Claude Desktop ( claude_desktop_config.json) para añadir el nuevo servidor MCP, utilizando el formato siguiente. Si el archivo ya existe, añada la entrada a mcpServers en el archivo config.

   Windows

   { "mcpServers": { "{classname_dash}": {"comando": "PATH\TO\\java.exe", "args": [ "-jar", "PATH\TO\CDataMCP-jar-with-dependencies.jar", "PATH\TO\\salesforce-einstein.prp" ], ... } }

   Linux/Mac

   { "mcpServers": {"{classname_dash}": {"command": "/PATH/TO/java", "args": [ "-jar", "/PATH/TO/CDataMCP-jar-with-dependencies.jar", "/PATH/TO/salesforce-einstein.prp" ] }, ... } }

   Si es necesario, copie el archivo de configuración al directorio apropiado (Claude Desktop como ejemplo).Windows

   cp C:\PATH\TO\claude_desktop_config.json %APPDATA%\Claude\claude_desktop_config.json

   Linux/Mac

   cp /PATH/TO/claude_desktop_config.json /Users/{user}/Library/Application\ Support/Claude/claude_desktop_config.json'

2. Ejecute o actualice su cliente (Claude Desktop).

Nota: Es posible que tenga que salir o cerrar completamente su cliente Claude Desktop y volver a abrirlo para que aparezcan los Servidores MCP.

Ejecutar el Servidor

1. Ejecute el siguiente comando para ejecutar el servidor MCP en su propio

   java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Nota: El servidor utiliza stdio, por lo que sólo puede utilizarse con clientes que se ejecuten en la misma máquina que el servidor.

Detalles de uso

Una vez configurado el servidor MCP, el cliente AI podrá utilizar las herramientas integradas para leer, escribir, actualizar y eliminar los datos subyacentes. En general, no es necesario llamar explícitamente a las herramientas. Basta con pedir al cliente que responda a preguntas sobre el sistema de datos subyacente. Por ejemplo:

• "¿Cuál es la correlación entre mis oportunidades ganadas cerradas y el sector de la cuenta?"
• "¿Cuántos tickets abiertos tengo en el proyecto SUPPORT?"
• "¿Puede decirme qué eventos de calendario tengo hoy?"

A continuación, la lista de herramientas disponibles y sus descripciones:

Herramientas y descripciones

En las definiciones siguientes, {servername} se refiere al nombre del servidor MCP en el archivo de configuración (por ejemplo, {classname_dash} arriba).

• {servername}_get_tables - Recupera una lista de tablas disponibles en la fuente de datos. Utilice la herramienta {servername}_get_columns para obtener una lista de las columnas disponibles en una tabla. La salida de la herramienta se devolverá en formato CSV, con la primera línea conteniendo las cabeceras de las columnas.
• {servername}_get_columns - Recupera una lista de columnas de una tabla. Utilice la herramienta {servername}_get_tables para obtener una lista de las tablas disponibles. La salida de la herramienta se devolverá en formato CSV, con la primera línea conteniendo las cabeceras de las columnas.
• {servername}_run_query - Ejecutar una consulta SQL SELECT

Ejemplos de peticiones JSON-RPC

Si está programando las solicitudes enviadas al servidor MCP en lugar de utilizar un cliente AI (por ejemplo, Claude), puede consultar los siguientes ejemplos de carga útil JSON (siguiendo la especificación JSON-RPC 2.0) al llamar a las herramientas disponibles.

source_get_tables

{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "source_get_tables", "arguments": {} } }

source_get_columns

{ "jsonrpc": "2.0", "id": 2, "method": "tools/call", "params": { "name": "source_get_columns", "arguments": { "table":  "Account" } }

source_run_query

{ "jsonrpc": "2.0", "id": 3, "method": "tools/call", "params": { "name": "source_run_query", "arguments": { "sql":  "SELECT * FROM [Account] WHERE [IsDeleted] = true" } }

Solución de problemas

1. Si no puede ver su Servidor CData MCP en Claude Desktop, asegúrese de que ha salido completamente de Claude Desktop (Windows: utilice el Administrador de Tareas, Mac: utilice el Monitor de Actividad)
2. Si Claude Desktop no puede recuperar datos, asegúrese de que ha configurado su conexión correctamente. Utilice el generador de cadenas de conexión para crear la cadena de conexión (véase más arriba) y cópiela en el archivo de propiedades (.prp).
3. Si tiene problemas para conectarse a su fuente de datos, póngase en contacto con el equipo de soporte de CData.
4. Si tiene problemas para utilizar el servidor MCP, o tiene cualquier otro comentario, únase a la Comunidad CData.

Licencia

Este servidor MCP está licenciado bajo la Licencia MIT. Esto significa que usted es libre de usar, modificar y distribuir el software, sujeto a los términos y condiciones de la Licencia MIT. Para más detalles, consulte el archivo LICENSE en el repositorio del proyecto.

Todas las fuentes compatibles