Graphlit

Servidor del Protocolo de Contexto de Modelo (MCP) para la Plataforma Graphlit

Descripción General

El Servidor del 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 de uso del cliente.

Ingiera cualquier contenido desde Slack, Discord, sitios web, Google Drive, correo electrónico, Jira, Linear o GitHub en un proyecto Graphlit, y luego busque y recupere conocimiento relevante dentro de un cliente MCP como Cursor, Windsurf, Goose o Cline.

Su proyecto Graphlit actúa como una base de conocimiento consultable y lista 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 al ser ingeridos. Los archivos de audio y video se transcribirán al ser ingeridos.

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

Puede leer más sobre los casos de uso y características del Servidor MCP en nuestro blog.

Vea nuestro último video de YouTube sobre el uso del Servidor MCP de Graphlit con el cliente Goose MCP.

Para cualquier pregunta sobre el uso del Servidor MCP, únase a nuestra comunidad en Discord y publique en el canal #mcp.

Herramientas

Recuperación

• Consultar Contenidos
• Consultar Colecciones
• Consultar Feeds
• Consultar Conversaciones
• Recuperar Fuentes Relevantes
• Recuperar Imágenes Similares
• Describir Visualmente una Imagen

RAG

• Solicitar Conversación al LLM

Extracción

• Extraer JSON Estructurado de Texto

Publicación

• Publicar como Audio (ElevenLabs Audio)
• Publicar como Imagen (Generación de Imágenes de OpenAI)

Ingestión

• Archivos
• Páginas Web
• Mensajes
• Publicaciones
• Correos Electrónicos
• Incidencias
• Texto
• Memoria (Corto Plazo)

Conectores de Datos

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

Web

• Rastreo Web
• Búsqueda Web (incluyendo Búsqueda de Podcasts)
• Mapeo Web
• Captura de Pantalla de Página

Notificaciones

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

Operaciones

• Configurar Proyecto
• Crear Colección
• Añadir Contenidos a la Colección
• Eliminar Contenidos de la Colección
• Eliminar Colección(es)
• Eliminar Feed(s)
• Eliminar Contenido(s)
• Eliminar Conversación(es)
• ¿Feed Completado?
• ¿Contenido Completado?

Enumeraciones

• Listar Canales de Slack
• Listar Equipos de Microsoft Teams
• Listar Canales de Microsoft Teams
• Listar Bibliotecas de SharePoint
• Listar Carpetas de SharePoint
• Listar Proyectos de Linear
• Listar Bases de Datos de Notion
• Listar Páginas de Notion
• Listar Carpetas de Dropbox
• Listar Carpetas de Box
• Listar Gremios de Discord
• Listar Canales de Discord
• Listar Calendarios de Google
• Listar Calendarios de Microsoft

Recursos

• Proyecto
• Contenidos
• Feeds
• Colecciones (de Contenido)
• Flujos de Trabajo
• Conversaciones
• Especificaciones

Requisitos Previos

Antes de comenzar, asegúrese de tener lo siguiente:

• Node.js instalado en su 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 API.

Configuración

El Servidor MCP de Graphlit admite variables de entorno para la autenticación y configuración:

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

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

Instalación

Instalación mediante VS Code

Para una instalación rápida, use uno de los botones de instalación en un clic a continuación:

Para la instalación manual, agregue el siguiente bloque JSON a su archivo de Configuración de Usuario (JSON) en VS Code. Puede hacerlo presionando Ctrl + Shift + P y escribiendo Preferences: Open User Settings (JSON).

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

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 IDE Windsurf, Cline debe usar NPX:

npx -y graphlit-mcp-server

Su archivo mcp_config.json debe configurarse de manera 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 IDE Cline, Cline debe usar NPX:

npx -y graphlit-mcp-server

Su archivo cline_mcp_settings.json debe configurarse de manera 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 IDE Cursor, Cursor debe usar NPX:

npx -y graphlit-mcp-server

Su archivo mcp.json debe configurarse de manera 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 usar el Servidor MCP de Graphlit en cualquier aplicación cliente MCP, use:

{
    "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. Solo 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": "your-slack-bot-token",
                "DISCORD_BOT_TOKEN": "your-discord-bot-token",
                "TWITTER_TOKEN": "your-twitter-token",
                "GOOGLE_EMAIL_REFRESH_TOKEN": "your-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": "your-github-pat",
                "JIRA_EMAIL": "your-jira-email",
                "JIRA_TOKEN": "your-jira-token",
                "NOTION_API_KEY": "your-notion-api-key"
            }
        }
    }
}

NOTA: al ejecutar 'npx' en Windows, es posible que deba 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 soporte con el Servidor MCP de Graphlit, envíe una Incidencia en GitHub.

Para soporte adicional con la Plataforma Graphlit, únase a nuestra comunidad en Discord.