Graphlit

Serveur Model Context Protocol (MCP) pour la plateforme Graphlit

Aperçu

Le serveur Model Context Protocol (MCP) permet l'intégration entre les clients MCP et le service Graphlit. Ce document décrit le processus de configuration et fournit un exemple de base d'utilisation du client.

Ingérez tout depuis Slack, Discord, des sites web, Google Drive, les e-mails, Jira, Linear ou GitHub dans un projet Graphlit, puis recherchez et récupérez les connaissances pertinentes dans un client MCP comme Cursor, Windsurf, Goose ou Cline.

Votre projet Graphlit agit comme une base de connaissances interrogeable et prête pour le RAG sur l'ensemble de vos outils de développement et de gestion de produit.

Les documents (PDF, DOCX, PPTX, etc.) et les pages web HTML seront extraits en Markdown lors de l'ingestion. Les fichiers audio et vidéo seront transcrits lors de l'ingestion.

L'exploration web et la recherche web sont intégrées en tant qu'outils MCP, sans nécessité d'intégrer séparément d'autres outils comme Firecrawl, Exa, etc.

Vous pouvez en savoir plus sur les cas d'utilisation et les fonctionnalités du serveur MCP sur notre blog.

Regardez notre dernière vidéo YouTube sur l'utilisation du serveur MCP Graphlit avec le client MCP Goose.

Pour toute question sur l'utilisation du serveur MCP, veuillez rejoindre notre communauté Discord et poster sur le canal #mcp.

Outils

Récupération

• Interroger les contenus
• Interroger les collections
• Interroger les flux
• Interroger les conversations
• Récupérer les sources pertinentes
• Récupérer les images similaires
• Décrire visuellement une image

RAG

• Conversation LLM par prompt

Extraction

• Extraire du JSON structuré à partir de texte

Publication

• Publier en audio (ElevenLabs Audio)
• Publier en image (OpenAI Image Generation)

Ingestion

• Fichiers
• Pages web
• Messages
• Posts
• E-mails
• Tickets
• Texte
• Mémoire (court terme)

Connecteurs de données

• Microsoft Outlook email
• Google Mail
• Notion
• Reddit
• Linear
• Jira
• GitHub Issues
• Google Drive
• OneDrive
• SharePoint
• Dropbox
• Box
• GitHub
• Slack
• Microsoft Teams
• Discord
• Twitter/X
• Podcasts (RSS)

Web

• Exploration web
• Recherche web (y compris recherche de podcasts)
• Cartographie web
• Capture d'écran de page

Notifications

• Slack
• E-mail
• Webhook
• Twitter/X

Opérations

• Configurer le projet
• Créer une collection
• Ajouter des contenus à la collection
• Supprimer des contenus de la collection
• Supprimer la/les collection(s)
• Supprimer le/les flux
• Supprimer le/les contenu(s)
• Supprimer la/les conversation(s)
• Le flux est-il terminé ?
• Le contenu est-il terminé ?

Énumérations

• Lister les canaux Slack
• Lister les équipes Microsoft Teams
• Lister les canaux Microsoft Teams
• Lister les bibliothèques SharePoint
• Lister les dossiers SharePoint
• Lister les projets Linear
• Lister les bases de données Notion
• Lister les pages Notion
• Lister les dossiers Dropbox
• Lister les dossiers Box
• Lister les guildes Discord
• Lister les canaux Discord
• Lister les calendriers Google
• Lister les calendriers Microsoft

Ressources

• Projet
• Contenus
• Flux
• Collections (de contenu)
• Workflows
• Conversations
• Spécifications

Prérequis

Avant de commencer, assurez-vous de disposer des éléments suivants :

• Node.js installé sur votre système (version recommandée 18.x ou supérieure).
• Un compte actif sur la plateforme Graphlit avec accès au tableau de bord des paramètres API.

Configuration

Le serveur MCP Graphlit prend en charge les variables d'environnement à définir pour l'authentification et la configuration :

• GRAPHLIT_ENVIRONMENT_ID : Votre ID d'environnement.
• GRAPHLIT_ORGANIZATION_ID : Votre ID d'organisation.
• GRAPHLIT_JWT_SECRET : Votre secret JWT pour signer le jeton JWT.

Vous pouvez trouver ces valeurs dans le tableau de bord des paramètres API de la plateforme Graphlit.

Installation

Installation via VS Code

Pour une installation rapide, utilisez l'un des boutons d'installation en un clic ci-dessous :

Pour une installation manuelle, ajoutez le bloc JSON suivant à votre fichier de paramètres utilisateur (JSON) dans VS Code. Vous pouvez le faire en appuyant sur Ctrl + Shift + P et en tapant Preferences: Open User Settings (JSON).

Optionnellement, vous pouvez l'ajouter à un fichier nommé .vscode/mcp.json dans votre espace de travail. Cela vous permettra de partager la configuration avec d'autres.

Notez que la clé mcp n'est pas nécessaire dans le fichier .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}"
        }
      }
    }
  }
}

Installation via Windsurf

Pour installer graphlit-mcp-server dans l'application IDE Windsurf, Cline doit utiliser NPX :

npx -y graphlit-mcp-server

Votre fichier mcp_config.json doit être configuré de manière similaire à :

{
    "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",
            }
        }
    }
}

Installation via Cline

Pour installer graphlit-mcp-server dans l'application IDE Cline, Cline doit utiliser NPX :

npx -y graphlit-mcp-server

Votre fichier cline_mcp_settings.json doit être configuré de manière similaire à :

{
    "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",
            }
        }
    }
}

Installation via Cursor

Pour installer graphlit-mcp-server dans l'application IDE Cursor, Cursor doit utiliser NPX :

npx -y graphlit-mcp-server

Votre fichier mcp.json doit être configuré de manière similaire à :

{
    "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",
            }
        }
    }
}

Installation via Smithery

Pour installer graphlit-mcp-server pour Claude Desktop automatiquement via Smithery :

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

Installation manuelle

Pour utiliser le serveur MCP Graphlit dans n'importe quelle application cliente MCP, utilisez :

{
    "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",
            }
        }
    }
}

Optionnellement, vous pouvez configurer les informations d'identification pour les connecteurs de données, tels que Slack, Google Email et Notion. Seuls GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID et GRAPHLIT_JWT_SECRET sont requis.

{
    "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"
            }
        }
    }
}

REMARQUE : lors de l'exécution de 'npx' sous Windows, vous devrez peut-être appeler explicitement npx via l'invite de commandes.

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

Support

Veuillez vous référer à la documentation de l'API Graphlit.

Pour obtenir de l'aide concernant le serveur MCP Graphlit, veuillez soumettre un ticket GitHub.

Pour une assistance supplémentaire concernant la plateforme Graphlit, veuillez rejoindre notre communauté Discord.