Servidor MCP do Ollama: conecte ferramentas, pesquisa Web e modelos locais

O que significa um servidor MCP do Ollama

MCP, ou Model Context Protocol, é uma forma padronizada para uma aplicação de IA descobrir e chamar ferramentas expostas por um servidor. Uma ferramenta pode pesquisar na Web, ler uma pasta permitida ou consultar um banco de dados. O Ollama é o runtime do modelo: carrega o modelo e gera respostas, mas um modelo local não transforma automaticamente o Ollama em host MCP.

Por isso, servidor MCP do Ollama pode descrever arquiteturas diferentes. Pode ser um servidor local que conversa com o Ollama ou um host MCP que usa um modelo Ollama e se conecta a um servidor de pesquisa. Normalmente, o host controla descoberta, aprovação, execução e retorno do resultado ao modelo.

Limites entre host, cliente, servidor e modelo

Uma arquitetura MCP comum tem quatro papéis. O host é a aplicação de IA e cria uma conexão de cliente para cada servidor. O servidor MCP anuncia ferramentas e executa chamadas aprovadas. O Ollama fica ao lado dessa cadeia como endpoint local de inferência.

O modelo não ganha um túnel automático para todas as ferramentas. O host apresenta os esquemas, o modelo pode pedir uma chamada, e o host valida os argumentos e executa. Depois decide quanto do resultado volta ao modelo.

Preparar o Ollama e um host compatível com MCP

Primeiro confirme que um modelo já funciona no Ollama. O daemon deve estar ativo, o modelo instalado e a API local respondendo antes de adicionar MCP. Se uma solicitação simples falhar, MCP só tornará o diagnóstico mais difícil.

Depois escolha uma aplicação que documente suporte a clientes MCP. A configuração pode ser JSON, tela de ajustes, perfil de desktop ou SDK. Não copie uma configuração de outro host sem verificar comando, transporte, variáveis de ambiente e aprovações padrão.

ollama list

ollama run <model-name> "Responda apenas pronto."

curl http://127.0.0.1:11434/api/tags

Conectar um modelo local do Ollama com segurança

Antes de chamar uma ferramenta, teste duas conexões. O host precisa alcançar o endpoint configurado do Ollama: em um desktop, localhost costuma funcionar; em um contêiner, pode ser necessário host.docker.internal ou um nome de serviço. Confirme também se o modelo ou a API suportam o formato de tool calling esperado pelo host.

A API do Ollama aceita definições de ferramentas e pode retornar chamadas, mas isso não é automaticamente uma implementação completa do MCP. Um host MCP costuma traduzir entre a mensagem do modelo e as mensagens MCP de listar ou chamar ferramentas. Teste o provedor Ollama e a conexão MCP separadamente.

curl http://127.0.0.1:11434/api/chat -H "Content-Type: application/json" -d "{\"model\":\"<model-name>\",\"messages\":[{\"role\":\"user\",\"content\":\"Verifique o estado atual deste projeto.\"}],\"tools\":[] }"

Adicionar pesquisa Web MCP sem colocar segredos no código

Um servidor MCP de pesquisa Web é um provedor de ferramentas, não uma garantia de resposta atual ou correta. Dependendo da implementação, ele chama uma API de pesquisa, navegador, metabusca ou provedor hospedado. Leia a documentação oficial sobre transporte, variáveis, retenção e runtime.

Muitos hosts usam um formato parecido com o exemplo, mas os nomes mudam. Trate-o como padrão conceitual. Guarde chaves no gerenciador de segredos ou ambiente do host, limite as ferramentas e comece com uma pesquisa somente leitura.

1. Confirmar a fonte

   Use o repositório ou a documentação oficial e verifique licença, atividade, runtime e transporte.

2. Começar com poucas permissões

   Permita primeiro search ou fetch, não escrita de arquivos, shell ou rede privada ampla.

3. Executar uma consulta controlada

   Use uma consulta segura e confira nome da ferramenta, argumentos e URLs retornadas.

{ "mcpServers": { "web-search": { "command": "npx", "args": ["-y", "<pacote-mcp-de-pesquisa>"], "env": { "SEARCH_API_KEY": "${SEARCH_API_KEY}" } } } }

Tornar as chamadas de ferramentas observáveis e auditáveis

Um fluxo confiável com um servidor MCP para Ollama deixa um registro de auditoria útil sem guardar conteúdo sensível. Registre o nome do servidor, a ferramenta, o horário de início, a duração, o resultado, a classe do erro e os domínios de origem. Oculte chaves de API, cabeçalhos de autorização, conteúdo de arquivos privados e segredos do usuário. Em pesquisas, preserve as URLs finais e uma contagem breve de resultados para que alguém possa verificar quais evidências chegaram ao modelo.

O host também deve mostrar a aprovação. Um argumento gerado pelo modelo é uma entrada não confiável. Valide URLs, caminhos de arquivo, tamanho da consulta, listas de domínios permitidos, tempos limite e número máximo de resultados antes de executar. Trate páginas obtidas da Web como texto não confiável, pois elas podem conter instruções de injeção de prompt que entram em conflito com o pedido do usuário.

Diagnosticar a conexão na ordem certa

Teste uma camada por vez: Ollama sem MCP, lista de ferramentas sem execução e depois uma chamada de baixo risco. Isso separa falhas de modelo, transporte, permissão e provedor.

Se o modelo responde de memória sem chamar uma ferramenta, confira a lista de ferramentas do host e o suporte a tool calling antes de mudar o prompt. Se a ferramenta funciona mas a resposta é ruim, examine o resultado bruto, as fontes, o corte de contexto e as instruções injetadas nas páginas.

API Ollama Web Search e pesquisa MCP

O termo Ollama Web Search pode indicar dois caminhos. A API oficial é um serviço hospedado com chaves, limites e fronteira de privacidade próprios. Um servidor MCP de pesquisa Web é uma ferramenta chamada por um host MCP; pode ser local, auto-hospedado ou usar outro provedor. Ambos podem trazer informação recente, mas a configuração não é igual.

Use o guia existente de Ollama Web Search para API oficial, web_fetch, privacidade, limites e SearXNG. Use esta página para hosts MCP, esquemas de ferramentas, permissões e conexões de clientes locais.