Pular para o conteúdo

Dê ferramentas ao MonstarX com conectores MCP

ResumindoEm Backend → Nuvem → Conectores → MCP, adicione um servidor MCP remoto com nome e endereço HTTPS, ou cole uma configuração JSON para adicionar vários de uma vez. O MonstarX verifica a conexão, lista as ferramentas do servidor e passa a poder usá-las no modo Criar naquele projeto. Até 32 servidores por projeto.

O MCP (Model Context Protocol) é um padrão comum para ferramentas de IA oferecerem habilidades umas às outras. Um servidor MCP é um serviço que oferece um conjunto de ferramentas: pesquisar em uma documentação, consultar algo nos sistemas da sua empresa, executar uma tarefa. Muitos produtos já publicam o seu.

Conecte um servidor MCP a um projeto e o MonstarX pode usar as ferramentas dele enquanto cria aquele app. Por exemplo, conecte um servidor de documentação e diga “consulte a documentação do provedor de pagamentos e crie o fluxo de reembolso do jeito que eles recomendam”.

  • Você precisa do endereço HTTPS público do servidor, que está na documentação do provedor. Ele costuma terminar em /mcp ou /sse.
  • Se o servidor exigir login, pegue um token de acesso ou uma chave de API com o provedor.
  1. Abra o seu projeto e clique em Backend na barra superior e depois em Nuvem.

  2. Em Conectores, encontre o cartão MCP e clique em Adicionar servidor.

  3. Preencha o formulário:

    • Nome do servidor — qualquer nome que você reconheça, como “Busca na documentação”.
    • URL do servidor — o endereço HTTPS do servidor.
    • Tipo de conexão — Streamable HTTP para servidores atuais, ou SSE legado se o provedor der um endereço SSE.
    • Token Bearer (opcional) — o token de acesso, se o servidor exigir.
    • Cabeçalhos personalizados (JSON, opcional) — para servidores que querem a chave em um cabeçalho próprio, como { "X-Api-Key": "…" }.
  4. Clique em Conectar e verificar ferramentas. O MonstarX se conecta ao servidor e lista as ferramentas dele antes de salvar qualquer coisa. Se não conseguir conectar, nada é salvo e ele diz o que verificar.

Sim, se você já tiver uma configuração MCP de outra ferramenta. Clique em Importar JSON em vez de Adicionar servidor, cole um objeto mcpServers e clique em Conectar e verificar ferramentas:

{
"mcpServers": {
"documentation": {
"url": "https://mcp.example.com/mcp"
},
"workspace": {
"type": "http",
"url": "https://tools.example.org/mcp",
"headers": { "Authorization": "Bearer YOUR_ACCESS_TOKEN" }
},
"legacy": {
"type": "sse",
"url": "https://legacy.example.net/sse"
}
}
}

O MonstarX verifica todos os servidores antes de salvar qualquer um deles. Cada nome precisa ser diferente. Servidores que iniciam um programa no seu computador (com command em vez de url) não podem ser importados.

Depois que um servidor está conectado e ativado, o MonstarX conhece as ferramentas dele e sabe quando recorrer a elas. Peça no chat como sempre e mencione o servidor se ajudar: “use o servidor Busca na documentação para ver como os webhooks funcionam”.

  • O modo Criar consegue consultar as ferramentas e usá-las.
  • Os modos Planejar e Conversar conseguem ver quais ferramentas existem, mas não usá-las.
  • Dois servidores podem ter ferramentas com o mesmo nome — o MonstarX não confunde uma com a outra.
  • Funciona também para apps importados.

Cada servidor no cartão MCP mostra quantas ferramentas tem e estes botões:

  • Clique na contagem de ferramentas para ver as ferramentas que ele oferece.
  • Verificar conexão conecta de novo e atualiza a lista de ferramentas, para quando o provedor acrescentar ferramentas.
  • Desativar impede o MonstarX de usar o servidor, mesmo em uma solicitação que já está em andamento. Ativar liga de novo.
  • Remover exclui o servidor e as credenciais salvas dele, depois que você confirma.
  • Servidores que rodam no seu próprio computador (iniciados com um comando) ou em uma rede privada ou localhost. O endereço precisa ser HTTPS e público.
  • Login por janela pop-up (OAuth interativo). Peça um token ao provedor e cole como token bearer.
  • Renovar um token que expira. Quando ele expirar, remova o servidor e adicione de novo com um novo token.
  • Recursos (resources) e prompts do MCP, e servidores que precisam fazer perguntas de volta ao MonstarX (sampling ou elicitation). Só as ferramentas são usadas.
  • Até 32 servidores por projeto.
  • As credenciais ficam em segredo. O endereço e qualquer token ou cabeçalho são criptografados. Eles nunca aparecem no chat, no código do app nem no app publicado.
  • Um projeto só. Os servidores pertencem ao projeto em que você os adicionou, e só o proprietário do projeto pode adicioná-los.
Onde encontro o endereço de um servidor MCP?

Na documentação do próprio provedor, normalmente em “MCP” ou “Integrações de IA”. É um endereço HTTPS que muitas vezes termina em /mcp.

Por que o MonstarX não consegue usar as ferramentas no modo Conversar?

As ferramentas podem alterar coisas em outros sistemas, então o MonstarX só as executa no modo Criar. Conversar e Planejar ainda conseguem ver quais ferramentas um servidor tem.

O servidor exige login. O que eu faço?

Peça ao provedor um token de acesso ou uma chave de API e cole em Token Bearer (opcional), ou em Cabeçalhos personalizados se o provedor indicar outro cabeçalho.

O meu token expirou. Como atualizo?

Remova o servidor e adicione de novo com o novo token. O MonstarX não renova tokens sozinho.

O meu app pode usar esses servidores MCP?

Não. Os conectores MCP servem ao MonstarX enquanto ele cria. Para dar um serviço ao seu app, use um conector ou peça ao MonstarX para integrá-lo com uma chave em Backend → Segredos. Para dados públicos em tempo real de um país — clima, transporte, registros —, use os dados por país, que o MonstarX hospeda.