MCP Gateway
Conecte seu agente de IA a qualquer serviço remoto pelo Model Context Protocol.
Quer conectar o Claude, o Cursor ou o VS Code ao seu espaço de trabalho? Esse é o MCP Server, a direção inversa. Esta página trata de conectar seu agente Sois AI para fora, a servidores MCP externos.
O MCP Gateway permite plugar servidores externos compatíveis com MCP no seu espaço de trabalho Sois AI. Uma vez conectado, seu agente de IA pode descobrir e chamar ferramentas nesses servidores: pesquisar issues no GitHub, consultar um banco de dados do Notion, enviar uma mensagem no Slack, tudo em linguagem natural. Sem código de integração sob medida. Sem middleware. Apenas uma conexão e uma conversa.
Como funciona
You: "Search GitHub for open issues labelled 'bug' in the acme/backend repo"
Agent: ✓ Found 7 open issues labelled 'bug'. Here's the list …
O agente localiza o servidor MCP certo, escolhe a ferramenta certa, passa os argumentos certos, cuida da autenticação e retorna o resultado. Você só pergunta.
Configurar um servidor
Vá até MCP Gateway na barra lateral e clique em Add Server.
Predefinições de início rápido
Escolha uma predefinição para preencher automaticamente os detalhes de conexão. Você só adiciona suas credenciais.
| Predefinição | O que conecta | Tipo de auth |
|---|---|---|
| GitHub | Repositórios, issues, PRs, busca de código | Bearer token |
| Brave Search | Busca na web, notícias, imagens | Chave de API |
| Slack | Canais, mensagens, usuários | Bearer token |
| Notion | Páginas, bancos de dados, blocos | Bearer token |
| Linear | Issues, projetos, ciclos | Bearer token |
Ou escolha Custom Server e configure tudo manualmente.
Configuração do servidor
| Campo | Descrição |
|---|---|
| Name | Um rótulo para este servidor (ex. "Production GitHub") |
| Endpoint URL | O endpoint MCP do servidor (ex. https://api.github.com/mcp) |
| Transport | Streamable HTTP ou Server-Sent Events (SSE) |
Autenticação
Cada servidor pode usar um de cinco métodos de autenticação. As credenciais de API Key, Bearer Token e Basic Auth são armazenadas com segurança no seu Password Vault; o gateway nunca vê os segredos brutos diretamente.
None
Para servidores públicos ou sem autenticação. Nenhuma credencial necessária.
API Key
Vincule uma entrada do Password Vault que contém a chave de API. O gateway a injeta automaticamente nas solicitações.
Bearer Token
Vincule uma entrada do Password Vault com um bearer token. Enviado como Authorization: Bearer <token> em cada solicitação.
Basic Auth
Vincule uma entrada do Password Vault com um nome de usuário e uma senha. Enviado como autenticação HTTP Basic padrão.
OAuth 2.0 + PKCE
Fluxo OAuth completo para os serviços que o exigem. Configure:
| Campo | Descrição |
|---|---|
| Authorization Endpoint | A URL de autorização do provedor (ex. https://provider.com/oauth/authorize) |
| Token Endpoint | A URL de token do provedor (ex. https://provider.com/oauth/token) |
| Client ID | O client ID do seu aplicativo OAuth |
| Client Secret | O client secret do seu aplicativo OAuth |
| Scopes | Lista de scopes OAuth separados por espaços |
Clique em Connect with OAuth para iniciar o fluxo PKCE. Uma janela do navegador abre, você autoriza e o gateway armazena o token. Os tokens são renovados automaticamente com uma margem de 5 minutos antes da expiração, sem intervenção manual.
Usar ferramentas MCP pelo agente
Uma vez que um servidor está conectado e as ferramentas descobertas, seu agente de IA pode chamá-las automaticamente.
Direcionamento explícito: Use @mcp no chat para dizer ao agente para usar ferramentas MCP.
@mcp Search for open pull requests on acme/frontend
Roteamento implícito: O roteador do agente detecta a intenção relacionada ao MCP a partir de palavras-chave como "GitHub", "Slack", "Notion" ou "MCP" e seleciona as ferramentas certas automaticamente.
Ver as ferramentas disponíveis
Abra qualquer servidor no MCP Gateway e vá para a seção Available Tools. Cada ferramenta mostra:
- Name o identificador da ferramenta no servidor remoto
- Description o que faz
- Input Schema os parâmetros que aceita (JSON Schema)
Os recursos expostos pelo servidor (registros de banco de dados, arquivos, respostas de API) aparecem em Available Resources.
Histórico de chamadas de ferramentas
Cada execução de ferramenta é registrada. Abra um servidor e vá para a aba History para ver:
| Coluna | Descrição |
|---|---|
| Tool | Nome da ferramenta que foi chamada |
| Status | Sucesso ou falha |
| Duration | Quanto tempo durou a chamada |
| Called By | Qual usuário ou agente a acionou |
| Time | Quando a chamada foi feita |
Monitoramento de integridade
Os servidores passam por uma verificação de integridade automaticamente a cada 10 minutos. Se um servidor ativo ficar inacessível, seu status muda para Error no explorador da barra lateral.
| Status | Significado |
|---|---|
| Active | Conectado e íntegro |
| Inactive | Desabilitado manualmente |
| Error | Inacessível ou falha de autenticação |
Você pode acionar uma verificação manual a qualquer momento com o botão Test Connection.
Referência de ferramentas do agente
O MCP Gateway expõe cinco ferramentas ao agente de IA, organizadas em três kits focados:
Examine kit
| Ferramenta | Descrição |
|---|---|
getMcpGatewayOverview |
Resumo de todos os servidores configurados: contagem total, divisão active/inactive/error, servidores conectados recentemente. O agente o chama primeiro para entender o que está disponível. |
List kit
| Ferramenta | Descrição |
|---|---|
mcpListServers |
Listar todos os servidores configurados com status, tipo de transporte e contagem de ferramentas. Filtre opcionalmente por status (active, inactive, error). |
mcpDiscoverTools |
Conectar-se a um servidor e buscar suas ferramentas e recursos. Retorna nomes, descrições e esquemas de entrada. |
Execute kit
| Ferramenta | Descrição |
|---|---|
mcpCallTool |
Executar uma ferramenta em um servidor remoto. Exige server_id e tool_name. Os argumentos são repassados à ferramenta remota. As credenciais são resolvidas automaticamente. Gated exige confirmação antes da execução. |
mcpReadResource |
Ler um recurso de um servidor por URI (ex. file:///path ou db://table/id). |
Exemplos
Descubra o que está disponível:
What MCP servers do I have connected?
Pesquise no GitHub:
@mcp Find all open issues assigned to me on acme/backend
Consulte o Notion:
@mcp Search my Notion workspace for pages about Q1 planning
Envie uma mensagem no Slack:
@mcp Post a message in #engineering saying the deploy is complete
Encadeie com dados do espaço de trabalho:
Find the Q1 report in my documents and post a summary to the #leadership Slack channel
O agente combina ferramentas MCP com ferramentas integradas do espaço de trabalho em uma única conversa. Sem orquestração.
Permissões
O acesso ao MCP Gateway é controlado pelo seu papel no espaço de trabalho:
| Permissão | Descrição |
|---|---|
| View MCP servers | Ver a lista de servidores configurados |
| View server details | Ver as ferramentas, recursos e histórico de um servidor |
| Create MCP servers | Adicionar novas conexões de servidor |
| Update MCP servers | Editar a configuração do servidor |
| Delete MCP servers | Remover conexões de servidor |
| Execute remote tools | Chamar ferramentas em servidores remotos pelo agente |
Os administradores podem atribuir essas permissões por papel em Settings > Permissions.
Prefere que clientes de IA externos se conectem ao seu espaço de trabalho? Consulte o MCP Server para conexões de entrada do Claude Desktop, Cursor, VS Code e qualquer cliente compatível com MCP.