MCP permite conectar uma aplicação IA com ferramentas e dados usando um contrato comum. Para entender isso, separa três perguntas: quem decide o que fazer, quem transporta solicitação e quem conduz a operação.
Conceitos de Chave
Model Context Protocol (MCP) Padroniza como as capacidades externas são encontradas e usadas. Reduz a integração particular entre cada aplicação e cada sistema, mas não remove configurações, credenciais, políticas e diferenças de suporte. O servidor compatível com A não faz permissão ler todos os seus arquivos ou modificar suas contas.
O Host É a aplicação que gerencia a interação e o contexto. Dentro do anfitrião, um Cliente MCP mantém a conexão com um Servidor MCPIsso expõe habilidades. O host A pode usar vários clientes para se conectar a vários servidores. O LLM e o loop do agente continuam a ter sua função: MCP não por si só dá pensamento ou substitui orquestração.
Módulo Objetivos
- Diferenciar hospedeiro, cliente e servidor sem confundi-los com o modelo.
- Escolha entre ferramentas, recursos e prompts, se necessário.
- Após a descoberta, invocação e retorno de uma ferramenta.
- Distinguir transporte MCP de chamadas que o servidor faz para outro API.
Recursos do servidor 3
| Capacidade | O que isso fornece? | Exemplo de apoio. |
|---|---|---|
| Tools | Operações com entradas descritas por um esquema. | consultar_pedido Reforma sua estado. |
| Recursos | Informações que o aplicativo pode incorporar como um contexto. | A política de retorno identificada pela URI. |
| Prompts | Modelos reutilizáveis que o usuário pode selecionar. | Modelo A para preparar um diagnóstico de incidência. |
Trata-se de ferramentas controladas pelo modelo porque o modelo pode decidir se candidatar a elas. A aplicação e o servidor mantêm os controles execução. Recursos são executados pela aplicação e prompts são oferecidos para escolha do usuário. Esses termos descrevem o padrão de interação e não dão autoridade irrestrita. O Documentação da capacidade do servidor Detalha a distinção.
Conexão, mensagens e transporte
Versão e capacidades são acordadas no estabelecimento da conexão. O cliente pode então descobrir ferramentas com tools/list e invocá-los com tools/call. O esquema comunica nomes, propósitos e argumentos. As respostas indicam resultados ou erros. MCP usa mensagens baseadas em JSON-RPC que ligam solicitações e respostas identificadoras. A notificação A não requer a mesma troca de resposta que uma solicitação.
com Stdio., cliente e servidor são comunicados pela entrada padrão e saída de um processo local. com Streamable HTTPO cliente está conectado a um endpoint HTTP; É adequado para servidores remotos e também pode ser usado localmente. Segurança e autenticação dependem do transporte e implantação. Verifique as capacidades da versão que você usa em Arquitectura oficial de MCP.
"Servidor de um fornecedor externo" não significa necessariamente "processo remoto". Você pode executar um pacote de terceiros localmente usando stdio e ter esse pacote chamada após uma nuvem API por HTTPS. São duas conexões diferentes. Essa diferença ajuda a localizar erros de credenciais, rede e configuração.
Exemplo passo a passo
Nossa equipe quer compartilhar uma consulta de ordem entre um agente LangChain e um assistente apoiado no desenvolvimento MCP.
Para publicar a operação, partes de uma Python funcionam como consultar_pedido, a registrar com @mcp.tool() e descrever sua intenção e seus argumentos. O SDK oficial Python gera o esquema que o cliente vai descobrir por tools/list; No recibo. tools/callO servidor , a valida os argumentos e executa a função registrada. FastMCP é a interface usada para demonstração de curso. e... Atual linha oficial SDK usar MCPServer. O esquema descreve entradas: elas não permitem acesso a ordens. Identidade, permissões e regras de negócios continuam exigindo controles explícitos.
- Expor
consultar_pedido(id_pedido)em um servidor. Sua descrição indica que ele só lê e requer um identificador concreto. - Configure a conexão e as credenciais autorizadas em cada host. O cliente inicia a sessão e consulta as ferramentas disponíveis.
- O usuário pergunta sobre ordem.
P-204. O modelo propõe chamada O hospedeiro aplica seu permissões. - O cliente envia
tools/callcom nome e argumentos. O servidor valida identidade e acesso antes de consultar o sistema de pedidos. - O servidor retorna um resultado como estado "em preparação" e uma data estimada, ou um erro se não houver acesso.
- O hospedeiro acrescenta essa observação ao contexto e o agente explica o resultado. A segundo host pode reutilizar a mesma capacidade se suportar seu protocolo, transporte e autenticação.
A prova valiosa não é que ambos os participantes escrevam respostas semelhantes: eles são que os traços mostram a ferramenta pretendida e o resultado certo. Se o assistente tem uma ferramenta equivalente, uma resposta apropriada não prova que você tem usado seu servidor.
Do exemplo local ao caso OCI
O servidor A pode encapsular um API OCI. O cliente MCP descreve o período e agrupamento. O servidor aplica as credenciais e consulta o API. Para validar a resposta, compare datas, moeda, fuso horário e alcance com um relatório autorizado da mesma fonte. A diferença não prova que MCP descomputado: pode haver um filtro diferente ou dados não estabelecidos.
Antes para executar um pacote externo verifica a proveniência e permissões. Para uma simples soma dentro de uma aplicação, uma função local é suficiente. MCP é especialmente útil quando a capacidade é compartilhada, permanece separada ou já existe em outro sistema.
Erros comuns.
- Assumir que
tools/listFerramentas de execução: apenas descubra-as. - Para mesclar um contexto recurso com uma função que modifica um registro.
- Atribuindo permissões, identidade ou raciocínio ao protocolo por si só.
- Grave segredos ou dados privados para purificar uma integração.
Exercício de arquitetura.
O host A inicia um servidor pela Stdio. O servidor olha para OCI por HTTPS. Você tem que configurar o cliente MCP como Streamable HTTP só porque os dados vêm da nuvem?
Solução
Não. O transporte MCP descreve a conexão entre cliente e servidor, neste caso é stdio. A conexão HTTPS do servidor para OCI é outra integração. Mudar o transporte sem mudar o implantação quebraria a comunicação. O lugar onde os dados estão não determina automaticamente o transporte MCP.
Fontes e revisão
Confere. Visão geral da arquitetura y Entendendo os servidores MCP. Para se candidatar a Oracle, conecte este módulo com MCP em Autonomous AI Database. Você tem que ser capaz de identificar ambas as extremidades de cada conexão antes de escolher transporte ou permissões.