O Model Context Protocol (MCP) é uma especificação aberta para conectar clientes de IA a ferramentas e dados externos. Um plug-in 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 plug-in que fornece apenas instruções e recursos pode consistir somente em 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 de prompt reutilizáveis.
- Instruções: Orientações gerais para usar as capacidades do servidor.
Os plug-ins usam principalmente ferramentas. Cada ferramenta tem um nome, uma descrição, um esquema de entrada e um esquema de saída opcional. Esses campos ajudam o modelo a decidir quando chamar a ferramenta e como usar seu resultado.
Como funcionam as chamadas de ferramentas
Quando um usuário pede algo que corresponde a uma ferramenta:
- O cliente descobre as ferramentas disponibilizadas pelo servidor MCP.
- O modelo seleciona uma ferramenta e fornece argumentos compatíveis com seu esquema de entrada.
- O servidor valida a solicitação, executa a operação e retorna um resultado.
- O modelo usa o resultado para continuar a conversa.
Os resultados das ferramentas devem funcionar sem uma interface personalizada. Retorne texto conciso ou conteúdo estruturado que forneça ao modelo informações suficientes para responder ao usuário. Um servidor MCP também pode retornar um recurso opcional de interface para clientes compatíveis com MCP Apps.
Transporte e autorização
Implante servidores MCP de produção em endpoints HTTPS estáveis usando o transporte HTTP com streaming. Se as ferramentas acessarem dados privados ou executarem ações para um usuário, proteja o servidor com o fluxo de autorização definido pela especificação MCP.
Para saber mais sobre o protocolo, consulte a especificação MCP. Os kits de desenvolvimento de software para Python e TypeScript fornecem implementações de servidor e funções auxiliares.
Próximo passo
Depois de definir as ferramentas de que seu plug-in precisa, crie o servidor MCP.