Transformar uma API REST em ferramentas
Transforme pontos de acesso externos em ferramentas que podem ser chamadas.
Transformar uma API REST em ferramentas é uma aula grátis de MCP Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de MCP Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de MCP Academy inclui 4 aulas no total.
Transforme pontos de acesso em ferramentas
Qualquer API REST pode se tornar ferramentas MCP. Cada ponto de acesso se torna uma função chamável que o modelo pode invocar para buscar ou enviar dados. 🌐
Faça chamadas HTTP a partir de uma ferramenta
Dentro de uma ferramenta, você faz uma solicitação HTTP comum e depois retorna a resposta como texto que o modelo pode ler e analisar.
Prefira um cliente assíncrono
Use um cliente assíncrono, como httpx, para que uma chamada lenta à API não bloqueie outras solicitações enquanto aguarda a rede.
import httpx
async with httpx.AsyncClient() as client:
r = await client.get(url)Mapeie parâmetros para argumentos
Exponha a consulta do ponto de acesso como argumentos da ferramenta. O modelo passa uma cidade ou um identificador, e você o insere na solicitação com segurança.
@mcp.tool()
async def get_weather(city: str) -> str:
...Mantenha os segredos no servidor
Armazene a chave da API no ambiente do servidor, nunca como argumento de uma ferramenta. O modelo nunca deve ver nem enviar credenciais.
key = os.environ["WEATHER_API_KEY"]Verifique o código de status
Verifique o status HTTP antes de confiar no corpo da resposta. Um 404 ou 500 significa que você deve informar um erro claro, não dados inúteis.
r.raise_for_status()Analise e reduza o JSON
A maioria das APIs retorna JSON. Analise-o e retorne apenas os campos necessários para a tarefa, para não inundar o modelo com informações irrelevantes.
data = r.json()
return data["temp_c"]Dê uma única tarefa a cada ferramenta
Associe um ponto de acesso a uma ferramenta focada, com um nome claro. Ferramentas granulares são mais fáceis de o modelo escolher corretamente.
Escreva descrições úteis
Descreva o que o ponto de acesso faz e quando usá-lo. Uma descrição precisa é o que permite ao modelo saber que deve chamar essa ferramenta.
Lide com falhas de rede
Envolva a chamada para que um tempo limite ou uma queda de conexão retorne uma mensagem de erro legível, em vez de derrubar todo o servidor.
Defina tempos limite razoáveis
Sempre passe um timeout, para que um serviço upstream travado não congele sua ferramenta indefinidamente à espera de uma resposta que nunca chega.
r = await client.get(url, timeout=10.0)Verificação rápida
Onde uma chave de API deve ficar?
Recapitulação: REST como ferramentas
Você envolveu os endpoints em ferramentas assíncronas: argumentos de entrada, chaves no servidor, verificações de status e JSON simplificado na saída. Agora, vamos agrupar as conexões. 🎯
Aprenda Python com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Transformar uma API REST em ferramentas” é grátis?
Sim — o texto completo de “Transformar uma API REST em ferramentas” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de MCP Academy, atualize para CoddyKit PRO. O curso de MCP Academy inclui 4 aulas no total.
O que vou aprender em “Transformar uma API REST em ferramentas”?
Transforme pontos de acesso externos em ferramentas que podem ser chamadas. Você pratica MCP Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar MCP Academy?
Nenhuma experiência prévia é necessária. MCP Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.
Quanto tempo leva a aula “Transformar uma API REST em ferramentas”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de MCP Academy?
Sim. Cada aula de MCP Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Expor consultas SQL com segurança
- Transformar uma API REST em ferramentas
- Agrupar conexões no ciclo de vida
- Armazenar em cache e limitar a taxa dos serviços upstream