Servidor de protocolo de contexto de modelo (MCP) para la plataforma Graphlit

Visión general

El Servidor de Protocolo de Contexto de Modelo (MCP) permite la integración entre clientes MCP y el servicio Graphlit. Este documento describe el proceso de configuración y proporciona un ejemplo básico del uso del cliente.

Ingest cualquier cosa de Slack, Discord, sitios web, Google Drive, correo electrónico, Jira, Linear o GitHub en un proyecto Graphlit - y luego buscar y recuperar los conocimientos pertinentes dentro de un cliente MCP como Cursor, Windsurf, ganso o Cline.

Su proyecto Graphlit actúa como una base de conocimientos con capacidad de búsqueda y preparada para RAG en todas sus herramientas de desarrollo y gestión de productos.

Los documentos (PDF, DOCX, PPTX, etc.) y las páginas web HTML se extraerán a Markdown en el momento de la ingesta. Los archivos de audio y vídeo se transcribirán en el momento de la ingesta.

El rastreo y la búsqueda web están incorporados como herramientas MCP, sin necesidad de integrar por separado otras herramientas como Firecrawl, Exa, etc.

Puede obtener más información sobre los casos de uso y las funciones del servidor MCP en nuestro blog.

Vea nuestro último vídeo en YouTube sobre el uso del Servidor MCP de Graphlit con el cliente MCP Goose.

Si tiene alguna pregunta sobre el uso del servidor MCP, únase a nuestra comunidad Discord y publíquela en el canal #mcp.

Herramientas

Recuperación

• Contenido de la consulta
• Colecciones de consultas
• Fuentes de consulta
• Conversaciones de consulta
• Recuperar fuentes relevantes
• Recuperar imágenes similares
• Describir visualmente una imagen

RAG

• Provocar conversación LLM

Extracción

• Extraer JSON estructurado de un texto

Publicar

• Publicar como audio (ElevenLabs Audio)
• Publicación como imagen (OpenAI Image Generation)

Ingestión

• Archivos
• Páginas web
• Mensajes
• Mensajes
• Correos electrónicos
• Asuntos
• Texto
• Memoria (a corto plazo)

Conectores de datos

• Correo electrónico de Microsoft Outlook
• Correo de Google
• Notion
• Reddit
• Linear
• Jira
• Cuestiones de GitHub
• Google Drive
• OneDrive
• SharePoint
• Dropbox
• Box
• GitHub
• Slack
• Microsoft Teams
• Discord
• Twitter/X
• Podcasts (RSS)

Web

• Rastreo web
• Búsqueda web (incluida la búsqueda de podcasts)
• Mapeo web
• Captura de pantalla

Notificaciones

• Slack
• Correo electrónico
• Webhook
• Twitter/X

Operaciones

• Configurar proyecto
• Crear colección
• Añadir contenido a la colección
• Eliminar contenidos de la colección
• Eliminar colección(es)
• Eliminar fuente(s)
• Eliminar contenido(s)
• Eliminar conversación(es)
• ¿Ha terminado el feed?
• ¿Ha terminado el contenido?

Enumeraciones

• Lista de canales de Slack
• Lista de equipos de Microsoft Teams
• Lista de canales de Microsoft Teams
• Lista de bibliotecas de SharePoint
• Lista de carpetas de SharePoint
• Lista de proyectos lineales
• Lista de bases de datos de nociones

Recursos

• Proyecto
• Contenido
• Fuentes
• Colecciones (de contenidos)
• Flujos de trabajo
• Conversaciones
• Especificaciones

Requisitos previos

Antes de empezar, asegúrese de que tiene lo siguiente

• Node.js instalado en tu sistema (se recomienda la versión 18.x o superior).
• Una cuenta activa en la Plataforma Graphlit con acceso al panel de configuración de la API.

Configuración

El servidor Graphlit MCP admite variables de entorno que se pueden establecer para la autenticación y la configuración:

• GRAPHLIT_ENVIRONMENT_ID: Su ID de entorno.
• GRAPHLIT_ORGANIZATION_ID: ID de su organización.
• GRAPHLIT_JWT_SECRET: Su secreto JWT para firmar el token JWT.

Puede encontrar estos valores en el panel de configuración de la API en la plataforma Graphlit.

Instalación

Instalación mediante VS Code

Para una instalación rápida, utilice uno de los botones de instalación de un solo clic que aparecen a continuación:

Para la instalación manual, añada el siguiente bloque JSON a su archivo de configuración de usuario (JSON) en VS Code. Puede hacerlo pulsando Ctrl + Mayús + P y escribiendo Preferencias: Abrir Configuración de Usuario (JSON).

Opcionalmente, puede añadirlo a un archivo llamado .vscode/mcp.json en su espacio de trabajo. Esto le permitirá compartir la configuración con otras personas.

Tenga en cuenta que la clave mcp no es necesaria en el archivo .vscode/mcp.json.

{ "mcp": { "inputs": [ { "type": "promptString", "id": "organization_id", "description": "Graphlit Organization ID", "password": true }, { "type": "promptString", "id": "environment_id", "description": "Graphlit Environment ID", "password": true }, { "type": "promptString", "id": "jwt_secret", "description": "Graphlit JWT Secret", "password": true } ], "servers": { "graphlit": { "command": "npx", "args": ["-y", "graphlit-mcp-server"], "env": {"GRAPHLIT_ORGANIZATION_ID": "${input:organization_id}", "GRAPHLIT_ENVIRONMENT_ID": "${input:environment_id}", "GRAPHLIT_JWT_SECRET": "${input:jwt_secret}" } } } }

Instalación mediante Windsurf

Para instalar graphlit-mcp-server en la aplicación Windsurf IDE, Cline debe utilizar NPX:

npx -y graphlit-mcp-server

Su archivo mcp_config.json debe estar configurado de forma similar a:

{ "mcpServers": { "graphlit-mcp-server": { "command": "npx", "args": [ "-y", "graphlit-mcp-server" ], "env": { "GRAPHLIT_ORGANIZATION_ID": "your-organization-id", "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id", "GRAPHLIT_JWT_SECRET": "your-jwt-secret", } } } }

Instalación mediante Cline

Para instalar graphlit-mcp-server en la aplicación Cline IDE, Cline debe usar NPX:

npx -y graphlit-mcp-server

Su archivo cline_mcp_settings.json debe estar configurado de forma similar a:

{ "mcpServers": { "graphlit-mcp-server": { "command": "npx", "args": [ "-y", "graphlit-mcp-server" ], "env": { "GRAPHLIT_ORGANIZATION_ID": "your-organization-id", "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id", "GRAPHLIT_JWT_SECRET": "your-jwt-secret", } } }

Instalación mediante cursor

Para instalar graphlit-mcp-server en la aplicación Cursor IDE, Cursor debe usar NPX:

npx -y graphlit-mcp-server

Su archivo mcp.json debe estar configurado de forma similar a:

{ "mcpServers": { "graphlit-mcp-server": { "command": "npx", "args": [ "-y", "graphlit-mcp-server" ], "env": { "GRAPHLIT_ORGANIZATION_ID": "your-organization-id", "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id", "GRAPHLIT_JWT_SECRET": "your-jwt-secret", } } } }

Instalación mediante Smithery

Para instalar graphlit-mcp-server para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @graphlit/graphlit-mcp-server --client claude

Instalación manual

Para utilizar el Graphlit MCP Server en cualquier aplicación cliente MCP, utilice:

{ "mcpServers": { "graphlit-mcp-server": { "command": "npx", "args": [ "-y", "graphlit-mcp-server" ], "env": { "GRAPHLIT_ORGANIZATION_ID": "your-organization-id", "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id", "GRAPHLIT_JWT_SECRET": "your-jwt-secret", } } } }

Opcionalmente, puede configurar las credenciales para los conectores de datos, como Slack, Google Email y Notion. Sólo se requieren GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID y GRAPHLIT_JWT_SECRET.

{ "mcpServers": { "graphlit-mcp-server": { "command": "npx", "args": [ "-y", "graphlit-mcp-server" ], "env": { "GRAPHLIT_ORGANIZATION_ID": "your-organization-id", "GRAPHLIT_ENVIRONMENT_ID": "your-environment-id", "GRAPHLIT_JWT_SECRET": "your-jwt-secret", "SLACK_BOT_TOKEN": "tu-slack-bot-token", "DISCORD_BOT_TOKEN": "your-discord-bot-token", "TWITTER_TOKEN": "your-twitter-token", "GOOGLE_EMAIL_REFRESH_TOKEN": "tu-google-refresh-token", "GOOGLE_EMAIL_CLIENT_ID": "your-google-client-id", "GOOGLE_EMAIL_CLIENT_SECRET": "your-google-client-secret", "LINEAR_API_KEY": "your-linear-api-key", "GITHUB_PERSONAL_ACCESS_TOKEN": "tu-github-pat", "JIRA_EMAIL": "tu-jira-email", "JIRA_TOKEN": "tu-jira-token", "NOTION_API_KEY": "your-notion-api-key" } } }

NOTA: al ejecutar 'npx' en Windows, es posible que tenga que llamar explícitamente a npx a través del símbolo del sistema.

"command": "C:\\Windows\\System32\cmd.exe /c npx"

Soporte

Consulte la documentación de la API de Graphlit.

Para obtener ayuda con el servidor Graphlit MCP, envíe una incidencia de GitHub.

Para obtener más ayuda con la plataforma Graphlit, por favor únase a nuestra comunidad Discord.