Eu Construí Meu Primeiro Agente de IA Que Entende Bitcoin -- Aqui Está Como

Um guia para iniciantes sobre MCP, agentgateway e bitcoin-mcp

Eu queria construir um agente de IA que pudesse responder perguntas sobre Bitcoin. Não a partir de uma FAQ estática -- quero dizer dados em tempo real. Altura do bloco atual. Congestionamento do mempool. Estimativas de taxas. Estatísticas de mineração.

Eu pensei que isso levaria dias de manipulação de API, dores de cabeça com autenticação e encanamento personalizado. Levou 10 minutos.

Aqui está o que eu aprendi.

O Problema

Modelos de IA são inteligentes, mas estão presos ao passado. Pergunte a Claude ou GPT sobre a altura do bloco atual do Bitcoin e você receberá uma resposta educada: "Eu não tenho acesso a dados em tempo real." Justo -- mas e se você pudesse dar a eles esse acesso?

É isso que o MCP faz.

O que é MCP?

Model Context Protocol (MCP) é um padrão aberto que permite que modelos de IA chamem ferramentas externas. Pense nisso como USB para IA: um plugue universal que conecta qualquer cliente de IA a qualquer fonte de dados. Um servidor MCP expõe ferramentas (como "obter a altura do bloco atual do Bitcoin"). Um cliente MCP (como Claude Desktop ou um script personalizado) chama essas ferramentas. O modelo de IA decide quais ferramentas chamar com base na sua pergunta.

A beleza está na separação de preocupações. A lógica do Bitcoin vive no servidor MCP. A lógica da IA vive no cliente. Eles falam o mesmo protocolo.

O que é agentgateway?

agentgateway é um proxy leve que fica entre seu cliente de IA e seus servidores MCP. Por que você precisa de um proxy? Algumas razões:

• Tradução de protocolo -- ele pode conectar diferentes transportes MCP (stdio, SSE, HTTP Streamable)
• Roteamento -- ele pode distribuir para múltiplos servidores MCP a partir de um único ponto de extremidade
• Segurança -- é onde você adicionaria autenticação, limitação de taxa e registro de auditoria em produção

Para nossos propósitos, ele nos dá um ponto de extremidade HTTP limpo ao qual qualquer cliente MCP pode se conectar.

A Pilha

Aqui está o que estamos construindo:

Cliente de IA  --->  agentgateway (porta 3000)  --->  bitcoin-mcp (porta 8000)

Três componentes. Dois comandos para iniciar. Um arquivo de configuração.

Vamos Construí-lo

Passo 1: Instalar bitcoin-mcp

pip install bitcoin-mcp

Essa é toda a integração do Bitcoin. O bitcoin-mcp vem com 49 ferramentas para consultar a rede Bitcoin, e funciona imediatamente -- sem chaves de API, sem nó local necessário. Ele se conecta à API Satoshi gratuita por padrão.

Passo 2: Iniciar bitcoin-mcp

bitcoin-mcp --transport sse --port 8000

Isso inicia um servidor MCP na porta 8000 usando transporte de Eventos Enviados pelo Servidor. Deixe este terminal em execução.

Passo 3: Obter agentgateway

Baixe o binário da página de lançamentos do agentgateway para sua plataforma.

Passo 4: Criar a Configuração

Salve isso como config-sse.yaml:

binds:
- port: 3000
  listeners:
  - routes:
    - policies:
        cors:
          allowOrigins: ["*"]
          allowHeaders: ["*"]
          exposeHeaders: ["Mcp-Session-Id"]
      backends:
      - mcp:
          targets:
          - name: bitcoin-mcp
            sse:
              url: http://localhost:8000/sse

Isso diz ao agentgateway para escutar na porta 3000 e encaminhar tudo para o bitcoin-mcp.

Passo 5: Iniciar agentgateway

./agentgateway -f config-sse.yaml

Passo 6: Conectar

Abra MCP Inspector:

npx @modelcontextprotocol/inspector

Defina o transporte como HTTP Streamable, insira http://localhost:3000 e clique em Conectar.

Vá para a aba Ferramentas. Você verá 49 ferramentas. Clique em get_situation_summary e pressione Chamar.

O Momento "Aha"

Quando chamei get_situation_summary pela primeira vez, recebi uma parede de dados estruturados: altura do bloco, taxa de hash, progresso de ajuste de dificuldade, tamanho do mempool, níveis de taxa, distribuição de pools de mineração. Dados reais. Ao vivo da rede Bitcoin.

Eu não escrevi nenhum código de Bitcoin. Eu não analisei nenhuma API. Eu não lidei com nenhuma autenticação. Eu instalei um servidor MCP, apontei um proxy para ele e conectei.

Foi aí que o MCP fez sentido para mim. A IA não precisa saber como o Bitcoin funciona. Ela só precisa saber qual ferramenta chamar. O servidor MCP cuida de todo o resto.

Eu experimentei mais ferramentas. get_fee_estimates me disse exatamente qual taxa usar para uma transação agora. analyze_mempool me mostrou o congestionamento atual. get_mining_info me deu dados de taxa de hash e dificuldade. Cada um retornou dados estruturados, precisos e em tempo real.

Então eu conectei isso ao Claude Desktop (apenas uma alteração de configuração de uma linha) e perguntei em linguagem natural: "Qual é o estado atual do mempool do Bitcoin?" Claude chamou as ferramentas certas automaticamente e me deu um resumo claro e conversacional respaldado por dados ao vivo.

O que Eu Aprendi

O MCP é mais simples do que eu esperava. Eu continuei procurando a pegadinha -- o passo de autenticação complexo, o arquivo de configuração obrigatório com 200 opções, a coisa que levaria uma hora para depurar. Não estava lá. O protocolo é genuinamente simples.

agentgateway resolve problemas reais. Sem ele, você precisaria que cada cliente de IA suportasse todos os transportes MCP. Com ele, você expõe um único ponto de extremidade HTTP e roteia para qualquer backend. É a peça que faltava entre "Eu tenho um servidor MCP" e "qualquer cliente pode usá-lo."

O ecossistema de ferramentas é o recurso matador. O bitcoin-mcp sozinho tem 49 ferramentas. Imagine empilhar múltiplos servidores MCP -- clima, bancos de dados, APIs, Bitcoin -- todos acessíveis através de um único gateway.