O Model Context Protocol (MCP) é uma especificação aberta para conectar clientes de IA a ferramentas e dados externos. Um plugin pode incluir um servidor MCP quando precisa consultar informações em tempo real, executar ações ou se integrar a outro serviço.
O servidor MCP é opcional. Um plugin que fornece apenas instruções e recursos pode ser composto exclusivamente por habilidades.
O que um servidor MCP oferece
Um servidor MCP pode disponibilizar:
- Ferramentas: funções que o modelo pode chamar com entradas estruturadas.
- Recursos: dados ou conteúdo que o cliente pode ler.
- Prompts: modelos reutilizáveis de prompts.
- Instruções: orientações gerais sobre como usar as funcionalidades do servidor.
Os plugins usam principalmente ferramentas. Cada ferramenta tem um nome, uma descrição, um schema de entrada e, opcionalmente, um schema de saída. Esses campos ajudam o modelo a decidir quando chamar a ferramenta e como usar o resultado.
Como funcionam as chamadas de ferramentas
Quando o usuário faz um pedido que uma ferramenta pode atender:
- O cliente identifica as ferramentas que o servidor MCP disponibiliza.
- O modelo seleciona uma ferramenta e fornece argumentos que seguem o schema de entrada da ferramenta.
- O servidor valida a solicitação, executa a operação e retorna um resultado.
- O modelo usa o resultado para continuar a conversa.
O modelo deve conseguir usar os resultados das ferramentas mesmo sem uma interface personalizada. Retorne um texto conciso ou conteúdo estruturado com informações suficientes para que o modelo responda ao usuário. O servidor MCP também pode retornar um recurso opcional de interface para clientes compatíveis com MCP Apps.
Transporte e autorização
Implante os servidores MCP de produção em endpoints HTTPS estáveis usando o transporte HTTP com suporte a streaming. Se as ferramentas acessarem dados privados ou executarem ações em nome de um usuário, proteja o servidor com o fluxo de autorização definido na especificação do MCP.
Para mais detalhes sobre o protocolo, consulte a especificação do MCP. Os kits de desenvolvimento de software para Python e TypeScript fornecem implementações de servidor e utilitários.
Próximo passo
Depois de definir as ferramentas de que seu plugin precisa, crie o servidor MCP.