Cérebro-MCP Documentos de Desenvolvedor Ferramentas para Claude IA em vez de Humanos

Um desenvolvedor responsável pela manutenção do servidor Brain-MCP, que dá memória ao Claude entre conversas, descobriu que o principal consumidor de sua documentação era o Claude, e não leitores humanos do GitHub. Eles adicionaram uma seção "Para Assistentes de IA" no topo do README contendo instruções comportamentais, em vez de apenas descrições de ferramentas.

Detalhes Principais do Experimento

O desenvolvedor criou uma página dedicada em brainmcp.dev/for-ai com orientações específicas para assistentes de IA. As instruções comportamentais no README funcionam como um prompt de sistema para o uso de ferramentas.

A diferença imediata observada foi que o Claude começou a usar ferramentas de forma mais inteligente — não apenas quando explicitamente solicitado, mas proativamente injetando contexto relevante quando o usuário mudava de tópico.

Padrão de Documentação para Consumo por IA

O desenvolvedor sugere que, se seu servidor MCP for consumido por uma IA, você deve escrever documentação especificamente para a IA. Isso inclui:

• Não apenas nomes de ferramentas e tipos de parâmetros
• Orientações reais sobre quando e como usar as ferramentas de forma eficaz
• Instruções comportamentais que influenciam como o Claude usa as ferramentas

Exemplos Específicos da Documentação

A documentação inclui orientações práticas como:

• Quando pesquisar proativamente (ex.: quando o usuário diz "onde parei" → chamar tunnel_state)
• Como apresentar resultados ("sintetize, não despeje resultados de busca brutos")
• Quando NÃO pesquisar (comandos puros, continuação do mesmo tópico)

Detalhes Técnicos

O servidor Brain-MCP pode ser instalado com: pipx install brain-mcp && brain-mcp setup

O projeto inclui 25 ferramentas, é 100% local e tem licença MIT.

O desenvolvedor está perguntando a outros desenvolvedores MCP se eles experimentaram abordagens semelhantes para influenciar como o Claude usa suas ferramentas além das descrições básicas.