Use a MetalAPI com assistentes de IA (MCP)

O que o servidor MCP faz

A MetalAPI mantém um servidor Model Context Protocol em https://metalapi.com/mcp. Depois de conectado, o seu assistente pode consultar preços ao vivo e históricos, converter valores, gerar gráficos de séries temporais e verificar o seu plano e uso, tudo a partir de um chat.

Há duas formas de se conectar:

• Login (OAuth): Claude, ChatGPT e outros apps compatíveis com conectores personalizados. Você faz login na MetalAPI (ou cria uma conta grátis) e aprova a conexão.
• Chave de API: Claude Code, Cursor, VS Code e qualquer cliente capaz de enviar um cabeçalho. Use uma chave do seu painel.

Claude (claude.ai e Claude Desktop)

1. Abra Settings → Connectors e escolha Add custom connector.
2. Dê a ele o nome MetalAPI e informe a URL https://metalapi.com/mcp.
3. Clique em Connect, faça login na MetalAPI e clique em Allow.

Depois, pergunte, por exemplo: "Qual é o preço do ouro em euros por grama hoje?"

ChatGPT

Em Settings → Apps & Connectors, crie um conector (developer mode) com a URL https://metalapi.com/mcp e autenticação OAuth. O ChatGPT abre a tela de login da MetalAPI; aprove a conexão e as ferramentas estarão prontas.

Claude Code

Adicione o servidor com a sua chave de API:

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

# Ou faça login em vez de usar uma chave: adicione-o sem --header e depois execute /mcp no Claude Code.

Cursor

Adicione a MetalAPI a ~/.cursor/mcp.json (ou a .cursor/mcp.json em um projeto):

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code (GitHub Copilot)

Crie .vscode/mcp.json; o VS Code pede a chave uma vez e a armazena com segurança:

{
  "inputs": [
    { "type": "promptString", "id": "metalapi-key", "description": "MetalAPI API key", "password": true }
  ],
  "servers": {
    "metalapi": {
      "type": "http",
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:metalapi-key}" }
    }
  }
}

Ferramentas

• get_latest_prices, get_historical_prices, convert, get_timeseries, get_fluctuation, get_ohlc, get_carat_prices: dados de mercado. Cada chamada conta como uma requisição do seu plano, exatamente como na API REST, e os dados são tão recentes quanto o seu plano permite.
• list_symbols, get_account, list_plans, list_api_keys: gratuitas.
• get_upgrade_link: um link seguro de checkout do Stripe para um plano maior. O seu assistente pode prepará-lo, mas só você pode pagar.
• create_api_key: cria uma chave para os seus próprios apps (somente quando conectado via login).

Para assistentes de programação com IA

Está criando uma integração com uma ferramenta de programação com IA? Indique a ela o llms.txt, o llms-full.txt completo ou a especificação OpenAPI; eles descrevem todos os endpoints, parâmetros e respostas.

Segurança

As conexões feitas via login aparecem em Settings → Connected apps no seu painel, onde você pode desconectá-las a qualquer momento. As chaves de API podem ser rotacionadas ou revogadas em API keys; uma chave em uma configuração MCP é tão sensível quanto uma no seu código.