Um host de agente pode precisar de uma conexão que ele consiga configurar. Um desenvolvedor de aplicação pode precisar de uma biblioteca para importar no código. Esses requisitos levam a superfícies de integração diferentes.
O que cada um fornece ao seu consumidor?
Um servidor MCP fornece uma interface de protocolo; um SDK fornece funções e tipos para uma linguagem de programação.
O guia de arquitetura MCP descreve servidores que expõem capacidades a clientes conectados. Um servidor pode rodar como um processo local ou fornecer um endpoint remoto.
| Interface | Consumidor | O que o consumidor usa | Responsabilidade de runtime |
|---|---|---|---|
| Servidor MCP | Um cliente MCP em um host de agente ou aplicação | Requisições de protocolo e capacidades descobertas | Alguém executa o processo do servidor ou o serviço remoto |
| API SDK | Código da aplicação | Métodos de biblioteca que chamam um API | A aplicação executa a biblioteca e gerencia sua integração |
| MCP SDK | Código que implementa um cliente ou servidor MCP | Tipos de protocolo e auxiliares de implementação | A aplicação ainda executa o cliente ou servidor resultante |
Um pacote SDK não se torna um servidor em execução apenas porque você o instala.
Um servidor pode usar um SDK?
Sim. Um desenvolvedor pode usar um SDK de protocolo para implementar um servidor MCP e, depois, usar outra biblioteca cliente dentro dos handlers dele.
A documentação de MCP SDK descreve bibliotecas para construir clientes e servidores. Aqui, SDK identifica código usado para implementar o protocolo.
Um API SDK tem um alvo diferente: ele chama a API de um serviço. Um servidor de pedidos hipotético poderia expor uma ferramenta de status de pedido cujo handler usa um API SDK para recuperar o pedido.
A interface MCP externa e a chamada API interna têm contratos separados. Suportar uma operação API não a expõe automaticamente como uma ferramenta MCP.
Quais responsabilidades permanecem na minha aplicação?
Sua aplicação ainda decide quais operações solicitar. Ela também decide como tratar os resultados.
Com um API SDK, seu código seleciona um método e fornece seus argumentos. Com MCP, o host roteia requisições por meio de um cliente até as capacidades expostas do servidor.
A arquitetura MCP deixa o uso do contexto de modelo pelo host fora do escopo do protocolo. Uma conexão de ferramenta não decide suas regras de negócio, política de autorização ou critérios de conclusão.
Para uma consulta de pedido, receber o status solicitado pode encerrar a tarefa. Para o envio de uma mensagem, submissão e entrega posterior são resultados distintos.
Como escolho uma integração Bird?
Você pode conectar um host de agente compatível ao servidor MCP da Bird, ou integrar código da aplicação por meio de um cliente API.
Para a via de biblioteca, a decisão entre Bird SDK cobre a escolha entre um SDK e HTTP direto. Para a via de ferramenta, o inventário Bird do seu cliente fornece os nomes de ferramentas disponíveis e os schemas de entrada.
Compare a operação de que você precisa na interface que pretende usar. A presença de uma operação em uma interface não garante sua presença em outra.
- Use a conexão MCP quando seu host precisar descobrir e invocar ferramentas Bird.
- Use um cliente API quando o código da sua aplicação seleciona e invoca as operações do serviço.
- Use um MCP SDK quando você estiver implementando o próprio cliente ou servidor de protocolo.