Documentação Oficial do MCP em Português
  1. Início rápido
Documentação Oficial do MCP em Português
  • Get Started
    • Introdução
    • Servidores de exemplo
    • Clientes de exemplo
    • Início rápido
      • Para os desenvolvedores de servidores
      • Para os desenvolvedores de clientes
      • Para utilizadores do Claude Desktop
  • Tutoriais
    • Construção de MCP com LLMs
    • Depuração
    • Inspetor
  • Conceitos
    • Arquitetura central
    • Recursos
    • Avisos
    • Ferramentas
    • Amostragem
    • Raízes
    • Transportes
  • Desenvolvimento
    • O que há de novo
    • Roteiro
    • Contribuindo
  1. Início rápido

Para os desenvolvedores de servidores

Comece a construir seu próprio servidor para usar no Claude para Desktop e outros clientes.
Neste tutorial, construiremos um servidor MCP de clima simples e o conectaremos a um host, o Claude para Desktop. Começaremos com uma configuração básica e, em seguida, avançaremos para casos de uso mais complexos.

O que construiremos#

Muitos LLMs (incluindo o Claude) atualmente não têm a capacidade de buscar a previsão e alertas de clima severo. Vamos usar o MCP para resolver isso!
Construiremos um servidor que expõe duas ferramentas: get-alerts e get-forecast. Em seguida, conectaremos o servidor a um host MCP (neste caso, o Claude para Desktop):
img
img
Os servidores podem se conectar a qualquer cliente. Escolhemos o Claude para Desktop aqui por simplicidade, mas também temos guias sobre como construir seu próprio cliente e uma lista de outros clientes aqui.
Por que Claude para Desktop e não Claude.ai?

Conceitos Essenciais do MCP#

Os servidores MCP podem fornecer três tipos principais de capacidades:
1.
Recursos: Dados semelhantes a arquivos que podem ser lidos por clientes (como respostas de API ou conteúdo de arquivos)
2.
Ferramentas: Funções que podem ser chamadas pelo LLM (com aprovação do usuário)
3.
Prompts: Modelos pré-escritos que ajudam os usuários a realizar tarefas específicas
Este tutorial se concentrará principalmente em ferramentas.
Python
Vamos começar a construir nosso servidor de clima! Você pode encontrar o código completo para o que construiremos aqui.

Conhecimento Prévio#

Este guia rápido pressupõe que você esteja familiarizado com:
Python
LLMs como Claude

Requisitos do Sistema#

Python 3.10 ou superior instalado.
Você deve usar o Python MCP SDK 1.2.0 ou superior.

Configure seu ambiente#

Primeiro, vamos instalar o uv e configurar nosso projeto e ambiente Python:
MacOS/Linux
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Certifique-se de reiniciar seu terminal depois para garantir que o comando uv seja reconhecido.
Agora, vamos criar e configurar nosso projeto:
MacOS/Linux
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item weather.py
Windows
# Create a new directory for our project
uv init weather
cd weather

# Create virtual environment and activate it
uv venv
.venv\Scripts\activate

# Install dependencies
uv add mcp[cli] httpx

# Create our server file
new-item weather.py
Agora vamos mergulhar na construção do seu servidor.

Construindo seu servidor#

Importando pacotes e configurando a instância#

Adicione estes ao topo do seu weather.py:
A classe FastMCP usa dicas de tipo Python e docstrings para gerar automaticamente definições de ferramentas, facilitando a criação e manutenção de ferramentas MCP.

Funções auxiliares#

Em seguida, vamos adicionar nossas funções auxiliares para consultar e formatar os dados da API do National Weather Service:

Implementando a execução da ferramenta#

O manipulador de execução da ferramenta é responsável por realmente executar a lógica de cada ferramenta. Vamos adicioná-lo:

Executando o servidor#

Finalmente, vamos inicializar e executar o servidor:
Seu servidor está completo! Execute uv run weather.py para confirmar se tudo está funcionando.
Vamos agora testar seu servidor a partir de um host MCP existente, o Claude para Desktop.

Testando seu servidor com o Claude para Desktop#

Claude para Desktop ainda não está disponível no Linux. Usuários Linux podem prosseguir para o tutorial Construindo um cliente para construir um cliente MCP que se conecta ao servidor que acabamos de construir.
Primeiro, certifique-se de ter o Claude para Desktop instalado. Você pode instalar a versão mais recente aqui. Se você já tem o Claude para Desktop, certifique-se de que ele esteja atualizado para a versão mais recente.
Precisaremos configurar o Claude para Desktop para quaisquer servidores MCP que você deseja usar. Para fazer isso, abra a configuração do seu aplicativo Claude para Desktop em ~/Library/Application Support/Claude/claude_desktop_config.json em um editor de texto. Certifique-se de criar o arquivo se ele não existir.
Por exemplo, se você tiver o VS Code instalado:
MacOS/Linux
Windows
code $env:AppData\Claude\claude_desktop_config.json
Em seguida, você adicionará seus servidores na chave mcpServers. Os elementos da interface do usuário MCP só aparecerão no Claude para Desktop se pelo menos um servidor estiver configurado corretamente.
Neste caso, adicionaremos nosso único servidor de clima assim:
MacOS/Linux
{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/weather",
                "run",
                "weather.py"
            ]
        }
    }
}
Windows
{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "C:\\ABSOLUTE\\PATH\\TO\\PARENT\\FOLDER\\weather",
                "run",
                "weather.py"
            ]
        }
    }
}
Você pode precisar colocar o caminho completo para o executável uv no campo command. Você pode obter isso executando which uv no MacOS/Linux ou where uv no Windows.
Certifique-se de passar o caminho absoluto para o seu servidor.
Isso diz ao Claude para Desktop:
1.
Existe um servidor MCP chamado "weather"
2.
Para iniciá-lo executando uv --directory /ABSOLUTE/PATH/TO/PARENT/FOLDER/weather run weather.py
Salve o arquivo e reinicie o Claude para Desktop.

Teste com comandos#

Vamos garantir que o Claude para Desktop esteja captando as duas ferramentas que expusemos em nosso servidor weather. Você pode fazer isso procurando o ícone de martelo img:
img
Depois de clicar no ícone de martelo, você deve ver duas ferramentas listadas:
img
Se o seu servidor não estiver sendo captado pelo Claude para Desktop, vá para a seção Solução de problemas para obter dicas de depuração.
Se o ícone de martelo apareceu, você pode agora testar seu servidor executando os seguintes comandos no Claude para Desktop:
Qual é o clima em Sacramento?
Quais são os alertas meteorológicos ativos no Texas?
img
img
Como este é o Serviço Meteorológico Nacional dos EUA, as consultas só funcionarão para locais nos EUA.

O que está acontecendo nos bastidores#

Quando você faz uma pergunta:
1.
O cliente envia sua pergunta para o Claude
2.
O Claude analisa as ferramentas disponíveis e decide quais usar
3.
O cliente executa as ferramentas escolhidas através do servidor MCP
4.
Os resultados são enviados de volta para o Claude
5.
O Claude formula uma resposta em linguagem natural
6.
A resposta é exibida para você!
Modified at 2025-03-12 10:00:34
Previous
Clientes de exemplo
Next
Para os desenvolvedores de clientes
Built with