salesforce-einstein-mcp-server-by-cdata

Servidor Model Context Protocol (MCP) de CData per a Salesforce Einstein

⚠️ Aquest projecte construïa un servidor MCP només de lectura. Per a capacitats completes de lectura, escriptura, actualització, esborrat i acció, i una instal·lació simplificada, consulteu el nostre CData MCP Server for Salesforce Einstein (beta).

Propòsit

Hem creat aquest servidor MCP només de lectura per permetre que els LLM (com Claude Desktop) consultin dades en temps real de Salesforce Einstein suportades pel CData JDBC Driver for Salesforce Einstein.

El CData JDBC Driver es connecta a Salesforce Einstein exposant-los com a models SQL relacionals.

Aquest servidor envolta aquest controlador i fa que les dades de Salesforce Einstein estiguin disponibles a través d’una interfície MCP simple, de manera que els LLM puguin recuperar informació en temps real fent preguntes en llenguatge natural — sense SQL.

Guia d'Instal·lació

• Clonau el repositori:
  git clone https://github.com/cdatasoftware/salesforce-einstein-mcp-server-by-cdata.git
cd salesforce-einstein-mcp-server-by-cdata
• Construeix el servidor:
  mvn clean install (crea el fitxer JAR: CDataMCP-jar-with-dependencies.jar)
• Descarrega i instal·la el CData JDBC Driver for Salesforce Einstein
• Licencieu el CData JDBC Driver:
  Pasos:
  
  • Vas a la carpeta lib del directori d’instal·lació, normalment:
    
    • (Windows) C:\Program Files\CData\CData JDBC Driver for Salesforce Einstein\
    • (Mac/Linux) /Applications/CData JDBC Driver for Salesforce Einstein/
  • Executeu la comanda java -jar cdata.jdbc..jar --license
  • Introduïu el vostre nom, correu electrònic i “TRIAL” (o la vostra clau de llicència).
• Configureu la vostra connexió a la font de dades (exemple: Salesforce):
  
  • Executeu java -jar cdata.jdbc..jar per obrir l’Utilitat de Cadena de Connexió.
  • Configureu la cadena de connexió i feu clic a “Test Connection”.
    

    Nota: Si la font de dades utilitza OAuth, haureu d’autenticar-vos al vostre navegador.

  • Un cop exitosa, copieu la cadena de connexió per a utilitzar-la més tard.
• Creu un fitxer .prp per a la vostra connexió JDBC (exemple: salesforce-einstein.prp) amb les propietats següents:
  
  • Prefix - prefix que s’utilitzarà per als eines exposats
  • ServerName - nom del vostre servidor
  • ServerVersion - versió del vostre servidor
  • DriverPath - camí complet al fitxer JAR del vostre controlador JDBC
  • DriverClass - nom de la classe del controlador JDBC (exemple: cdata.jdbc..Driver)
  • JdbcUrl - cadena de connexió JDBC a utilitzar amb el CData JDBC Driver per connectar-vos a les dades (copiada anteriorment)
  • Tables - deixeu en blanc per accedir a totes les dades, o declareu explícitament les taules a les quals voleu accedir
  Prefix=
ServerName=CData
ServerVersion=1.0
DriverPath=PATH\TO\cdata.jdbc..jar
DriverClass=cdata.jdbc..Driver
JdbcUrl=jdbc::InitiateOAuth=GETANDREFRESH;
Tables=

Utilitzar el Servidor amb Claude Desktop

• Creu el fitxer de configuració per a Claude Desktop (claude_desktop_config.json) per afegir el nou servidor MCP, utilitzant el format següent. Si el fitxer ja existeix, afegiu l’entrada a mcpServers dins del fitxer de configuració.
  Windows
  {
"mcpServers": {
"{classname_dash}": {
"command": "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 cal, copieu el fitxer de configuració al directori apropiat (exemple: Claude Desktop).
  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
• Executeu o actualitzeu el vostre client (Claude Desktop).

Nota: És possible que hàgiu de tancar completament el client Claude Desktop i reobrir-lo perquè els Servidors MCP apareguin.

Executar el Servidor

• Executeu la comanda següent per fer funcionar el servidor MCP per separat:
  java -jar /PATH/TO/CDataMCP-jar-with-dependencies.jar /PATH/TO/Salesforce.prp

Nota: El servidor utilitza stdio i només pot ser utilitzat amb clients que s’executin a la mateixa màquina que el servidor.

Detalls d'Ús

Un cop configurat el servidor MCP, el client d’IA podrà utilitzar els eines integrats per llegir, escriure, actualitzar i esborrar les dades subjacents. En general, no cal trucar explícitament les eines. Simplement pregunteu al client que respongui preguntes sobre el sistema de dades subjacents. Per exemple:

• «Quina és la correlació entre les meves oportunitats tancades guanyades i la indústria del compte?»
• «Quants tickets oberts tinc al projecte SUPPORT?»
• «Em pots dir quins esdeveniments del calendari tinc avui?»

La llista d’eines disponibles i les seves descripcions segueix:

Eines i Descripcions

En les definicions següents, {servername} es refereix al nom del servidor MCP al fitxer de configuració (exemple: {classname_dash}).

• {servername}_get_tables - Recupera una llista de taules disponibles a la font de dades. Utilitzeu l’eina {servername}_get_columns per llistar les columnes disponibles d’una taula. La sortida de l’eina es retornarà en format CSV, amb la primera línia que conté les capçaleres de columna.
• {servername}_get_columns - Recupera una llista de columnes d’una taula. Utilitzeu l’eina {servername}_get_tables per obtenir una llista de taules disponibles. La sortida de l’eina es retornarà en format CSV, amb la primera línia que conté les capçaleres de columna.
• {servername}_run_query - Executa una consulta SQL SELECT.

Exemples de Sol·licituds JSON-RPC

Si esteu escrivint les sol·licituds enviades al servidor MCP en lloc d’utilitzar un client d’IA (exemple: Claude), podeu fer referència als exemples de càrrega JSON següents – seguint la especificació JSON-RPC 2.0 – quan truqueu les eines disponibles.

source_get_tables

source_get_columns

source_run_query

Resolució de Problemes

• Si no podeu veure el vostre CData MCP Server a Claude Desktop, assegureu-vos de tancar completament Claude Desktop (Windows: use Task Manager, Mac: use Activity Monitor).
• Si Claude Desktop no pot recuperar dades, assegureu-vos d’haver configurat correctament la vostra connexió. Utilitzeu l’Editor de Cadena de Connexió per crear la cadena de connexió (vegeu més amunt) i copieu la cadena al fitxer de propietats (.prp).
• Si teniu problemes per connectar-vos a la font de dades, contacteu amb l’equip de CData Support Team.
• Si teniu problemes amb el servidor MCP o teniu qualsevol altra retroalimentació, uniu-vos a la CData Community.

Licència

Aquest servidor MCP està llicenciat sota la MIT License. Això significa que podeu utilitzar, modificar i distribuir el programari lliurement, subjecte als termes i condicions de la MIT License. Per a més detalls, consulteu el fitxer LICENSE al repositori del projecte.

Totes les Fonts Suportades