Graphlit

Servidor Model Context Protocol (MCP) para a Plataforma Graphlit

Visão Geral

O Servidor Model Context Protocol (MCP) permite a integração entre clientes MCP e o serviço Graphlit. Este documento descreve o processo de configuração e fornece um exemplo básico de uso do cliente.

Ingira qualquer conteúdo do Slack, Discord, sites, Google Drive, e-mail, Jira, Linear ou GitHub em um projeto Graphlit - e então pesquise e recupere conhecimento relevante dentro de um cliente MCP como Cursor, Windsurf, Goose ou Cline.

Seu projeto Graphlit atua como uma base de conhecimento pesquisável e pronta para RAG em todas as suas ferramentas de desenvolvimento e gerenciamento de produtos.

Documentos (PDF, DOCX, PPTX, etc.) e páginas web HTML serão extraídos para Markdown durante a ingestão. Arquivos de áudio e vídeo serão transcritos durante a ingestão.

O rastreamento web e a busca na web são integrados como ferramentas MCP, sem necessidade de integrar outras ferramentas como Firecrawl, Exa, etc. separadamente.

Você pode ler mais sobre os casos de uso e recursos do Servidor MCP em nosso blog.

Assista ao nosso mais recente vídeo no YouTube sobre o uso do Servidor MCP Graphlit com o cliente Goose MCP.

Para qualquer dúvida sobre o uso do Servidor MCP, junte-se à nossa comunidade no Discord e poste no canal #mcp.

Ferramentas

Recuperação

• Consultar Conteúdos
• Consultar Coleções
• Consultar Feeds
• Consultar Conversas
• Recuperar Fontes Relevantes
• Recuperar Imagens Similares
• Descrever Imagem Visualmente

RAG

• Solicitar Conversa com LLM

Extração

• Extrair JSON Estruturado de Texto

Publicação

• Publicar como Áudio (ElevenLabs Audio)
• Publicar como Imagem (OpenAI Image Generation)

Ingestão

• Arquivos
• Páginas Web
• Mensagens
• Postagens
• E-mails
• Issues
• Texto
• Memória (Curto Prazo)

Conectores de Dados

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

Web

• Rastreamento Web
• Busca na Web (incluindo Busca de Podcasts)
• Mapeamento Web
• Captura de Tela de Página

Notificações

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

Operações

• Configurar Projeto
• Criar Coleção
• Adicionar Conteúdos à Coleção
• Remover Conteúdos da Coleção
• Excluir Coleção(ões)
• Excluir Feed(s)
• Excluir Conteúdo(s)
• Excluir Conversa(s)
• Feed Concluído?
• Conteúdo Concluído?

Enumerações

• Listar Canais do Slack
• Listar Equipes do Microsoft Teams
• Listar Canais do Microsoft Teams
• Listar Bibliotecas do SharePoint
• Listar Pastas do SharePoint
• Listar Projetos do Linear
• Listar Bancos de Dados do Notion
• Listar Páginas do Notion
• Listar Pastas do Dropbox
• Listar Pastas do Box
• Listar Guilds do Discord
• Listar Canais do Discord
• Listar Calendários do Google
• Listar Calendários da Microsoft

Recursos

• Projeto
• Conteúdos
• Feeds
• Coleções (de Conteúdo)
• Fluxos de Trabalho
• Conversas
• Especificações

Pré-requisitos

Antes de começar, certifique-se de ter o seguinte:

• Node.js instalado em seu sistema (versão recomendada 18.x ou superior).
• Uma conta ativa na Plataforma Graphlit com acesso ao painel de configurações da API.

Configuração

O Servidor MCP Graphlit suporta variáveis de ambiente a serem definidas para autenticação e configuração:

• GRAPHLIT_ENVIRONMENT_ID: Seu ID de ambiente.
• GRAPHLIT_ORGANIZATION_ID: Seu ID de organização.
• GRAPHLIT_JWT_SECRET: Seu segredo JWT para assinar o token JWT.

Você pode encontrar esses valores no painel de configurações da API na Plataforma Graphlit.

Instalação

Instalando via VS Code

Para instalação rápida, use um dos botões de instalação com um clique abaixo:

Para instalação manual, adicione o seguinte bloco JSON ao seu arquivo de Configurações do Usuário (JSON) no VS Code. Você pode fazer isso pressionando Ctrl + Shift + P e digitando Preferences: Open User Settings (JSON).

Opcionalmente, você pode adicioná-lo a um arquivo chamado .vscode/mcp.json em seu espaço de trabalho. Isso permitirá que você compartilhe a configuração com outras pessoas.

Note que a chave mcp não é necessária no arquivo .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}"
        }
      }
    }
  }
}

Instalando via Windsurf

Para instalar o graphlit-mcp-server no aplicativo Windsurf IDE, o Cline deve usar NPX:

npx -y graphlit-mcp-server

Seu arquivo mcp_config.json deve ser configurado de forma semelhante 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",
            }
        }
    }
}

Instalando via Cline

Para instalar o graphlit-mcp-server no aplicativo Cline IDE, o Cline deve usar NPX:

npx -y graphlit-mcp-server

Seu arquivo cline_mcp_settings.json deve ser configurado de forma semelhante 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",
            }
        }
    }
}

Instalando via Cursor

Para instalar o graphlit-mcp-server no aplicativo Cursor IDE, o Cursor deve usar NPX:

npx -y graphlit-mcp-server

Seu arquivo mcp.json deve ser configurado de forma semelhante 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",
            }
        }
    }
}

Instalando via Smithery

Para instalar o graphlit-mcp-server para Claude Desktop automaticamente via Smithery:

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

Instalando manualmente

Para usar o Servidor MCP Graphlit em qualquer aplicativo 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, você pode configurar as credenciais para conectores de dados, como Slack, Google Email e Notion. Apenas GRAPHLIT_ORGANIZATION_ID, GRAPHLIT_ENVIRONMENT_ID e GRAPHLIT_JWT_SECRET são obrigatórios.

{
    "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: ao executar 'npx' no Windows, pode ser necessário chamar explicitamente o npx através do prompt de comando.

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

Suporte

Consulte a Documentação da API Graphlit.

Para suporte com o Servidor MCP Graphlit, envie uma Issue no GitHub.

Para suporte adicional com a Plataforma Graphlit, junte-se à nossa comunidade no Discord.