Graphlit

oficial

Ingira qualquer coisa, desde Slack até Gmail e feeds de podcast, além de rastreamento web, em um projeto Graphlit pesquisável.

O que você pode fazer com Graphlit MCP?

  • Ingest content from tools like Slack, Jira, or GitHub — ask your assistant to ingest messages, issues, or files from connected data sources into your Graphlit project.
  • Search across all ingested knowledge — use Query Contents or Retrieve Relevant Sources to find documents, messages, web pages, and transcripts.
  • Ask questions against your project — prompt the LLM with Prompt LLM Conversation to get RAG-based answers grounded in your ingested content.
  • Crawl and search the web — use built-in Web Crawling and Web Search tools to pull in external pages or podcast results.
  • Extract structured data from text — apply Extract Structured JSON from Text to pull typed information out of unstructured content.
  • Manage collections and feeds — create, update, or delete collections and feeds, and check ingestion status with Is Feed Done? or Is Content Done?.

Documentação

npm version smithery badge

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.

graphlit-mcp-server MCP server

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:

Install with NPX in VS Code Install with NPX in VS Code Insiders

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.