# Conectar agentes de IA (MCP)

Conecte qualquer agente de IA a **10,000+ APIs** em minutos usando uma única URL. Funciona com OpenClaw, Claude Code/Desktop, Cursor, Devin, Cline — qualquer cliente de IA compatível com MCP.

**Sua chave de acesso à API**
Você precisa de uma chave API Zyla para usar este servidor MCP

[Obter chave API](https://zylalabs.com/pt/register)
[Entrar](https://zylalabs.com/pt/login)

## Entregue isto ao seu agente

**mcp.zylalabs.com**
Funciona com OpenClaw, Claude Code/Desktop, Cursor, Devin, Cline e qualquer cliente de IA compatível com MCP.

$
set up zyla - https://zylalabs.com/llms.txt

Cole no Claude Code, Cursor, Codex ou em qualquer agente de IA. Ele lê as instruções, pede sua API key e se conecta sozinho.

Seu agente se conectará automaticamente ao servidor MCP da Zyla, descobrirá 10,000+ APIs e estará pronto para chamá-las. Nenhuma configuração extra necessária.

Já conectou com a URL do MCP? Continua funcionando, não precisa mudar nada.
Não está funcionando? Veja [Compatibilidade e configuração por cliente](#compatibility) para instruções detalhadas.

## Ou apenas a URL do MCP

Se seu agente pedir apenas a URL, copie isto:

```text
https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY
```

## Configuração JSON para clientes desktop

Alguns clientes como Claude Desktop, Cursor ou Devin requerem um arquivo de configuração JSON. Cole isso e salve:

```json
{
  "mcpServers": {
    "zyla-api-hub": {
      "url": "https://mcp.zylalabs.com/mcp?apikey=YOUR_ZYLA_API_KEY"
    }
  }
}
```

- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), `%APPDATA%\Claude\claude_desktop_config.json` (Windows)

- **Cursor:** `.cursor/mcp.json`

- **Cline:** `~/.config/cline/mcp_settings.json`

## O que é MCP?

O **Model Context Protocol (MCP)** é um padrão aberto que permite que agentes de IA descubram e chamem ferramentas externas. O servidor MCP da Zyla transforma 10,000+ APIs REST em ferramentas que qualquer agente de IA pode usar — seu agente pode pesquisar o catálogo, ler documentação de APIs e executar chamadas API ao vivo, tudo por linguagem natural.

- **Uma URL, todas as APIs** Um único endpoint MCP dá ao seu agente acesso a todo o catálogo. Nenhuma configuração por API necessária.

- **Sua chave API existente** A autenticação é tratada automaticamente. Sua chave API Zyla está incorporada na URL.

- **Zero instalação** Sem SDKs, sem pacotes, sem contêineres Docker. Basta colar a URL e pronto.

## Como funciona

Quando seu agente de IA se conecta ao servidor MCP do Zyla API Hub, eis o que acontece nos bastidores:

- **Conectar** Seu cliente de IA se conecta ao `mcp.zylalabs.com` usando sua chave API. O servidor anuncia as ferramentas disponíveis.

- **Você faz uma pergunta** Você escreve algo como "Converter 100 USD para EUR". A IA decide quais ferramentas usar.

- **Pesquisar e descobrir** O agente chama `search_catalog` para encontrar uma API de conversão de moeda, depois `get_api_info` para ler seus endpoints e parâmetros.

- **Chamar a API** O agente chama `call_api` com os parâmetros corretos. O servidor MCP executa a chamada API real e retorna a resposta.

- **Obter sua resposta** O agente formata a resposta: "100 USD = 92,34 EUR (taxa: 0,9234)". Tudo em segundos, totalmente automatizado.

## Experimente

Após conectar, tente perguntar ao seu agente. Não precisa assinar cada API primeiro &mdash; o Zyla API Hub ativa automaticamente um plano pague-conforme-usa na primeira vez que seu agente chama qualquer API:

- "Convert 100 USD to EUR"

- "What's the weather in Buenos Aires?"

- "Validate the email hello@example.com"

- "Search for finance APIs"

- "Get the BIN info for card 411111"

- "Browse all sports APIs, page 2"

- "Check my account status and API usage"

- "Get the IP geolocation for 8.8.8.8"

## Experiência Completa pelo Agente

Você pode fazer tudo pelo seu agente de IA sem precisar visitar zylalabs.com:

- **Criar conta** Diga ao agente seu nome, email e senha. Ele usa a ferramenta `register` para criar sua conta e obter uma chave API.

- **Descobrir APIs** Peça ao agente para buscar APIs por palavra-chave (`search_catalog`) ou navegar por categoria (`browse_catalog`).

- **Chamar APIs** Seu agente chama a API com `call_api`. Assinaturas são criadas automaticamente no primeiro uso.

- **Adicionar pagamento** Quando necessário, seu agente obtém um link do Stripe Checkout via `get_payment_url`. Abra no navegador para adicionar seu cartão.

- **Verificar status** Use `account_status` a qualquer momento para ver seu plano, uso e dados de cobrança.

## Ferramentas MCP disponíveis

Quando conectado, seu agente de IA tem acesso a estas ferramentas. O agente escolhe qual chamar com base na sua solicitação:

|
Ferramenta |
O que faz |
Exemplo |

| `search_catalog` | Pesquise em 10,000+ APIs por palavra-chave. Retorna APIs correspondentes com ID, nome, descrição, categoria e número de endpoints. | `search_catalog({ query: "currency exchange", limit: 5 })` |

| `browse_catalog` | Navegue pelo catálogo completo com paginação. Filtre por categoria, palavra-chave ou ordem de classificação. Acesse TODAS as APIs públicas além do top 500. | `browse_catalog({ category: "Sports & Gaming", page: 1 })` |

| `list_categories` | Liste todas as categorias de API (Finanças, Clima, IA, Esportes, Tradução, etc.) com a contagem de APIs em cada uma. | `list_categories()` |

| `get_api_info` | Obtenha documentação completa de uma API específica: cada endpoint, todos os parâmetros (nome, tipo, obrigatório/opcional) e valores de exemplo. | `get_api_info({ api_id: 1234 })` |

| `call_api` | Execute uma chamada API ao vivo. Passe o ID da API, ID do endpoint, método HTTP e parâmetros. Retorna os dados de resposta reais. | `call_api({ api_id: 1234, endpoint_id: 5678, params: { from: "USD", to: "EUR" } })` |

| `register` | Crie uma nova conta Zyla diretamente do agente de IA. Retorna uma chave API instantaneamente. Sem necessidade de visitar o site. | `register({ name, email, password })` |

| `account_status` | Verifique o status da sua conta: info do plano, uso de chamadas API e se há método de pagamento registrado. Útil para diagnosticar problemas. | `account_status()` |

| `get_payment_url` | Obtenha um link do Stripe Checkout para adicionar ou atualizar seu cartão de crédito. O usuário abre o link no navegador para completar a configuração de pagamento. | `get_payment_url()` |

Os provedores também têm as ferramentas provider_* para publicar e atualizar suas próprias APIs.
[Publique com seu agente de IA](https://zylalabs.com/pt/docs/publish-with-agent)

## Para quem é isto?

- **Desenvolvedores construindo agentes de IA** Dê ao seu agente acesso a dados do mundo real &mdash; taxas de câmbio, clima, validação de email, geolocalização e mais &mdash; sem escrever integrações API personalizadas.

- **Codificação assistida por IA (Cursor, Devin, Cline)** Consulte APIs diretamente do seu IDE. Precisa testar um endpoint ou verificar dados? Pergunte ao seu assistente de código e ele chama a API para você.

- **Usuários de Claude Desktop & ChatGPT** Transforme seu chat de IA em um cliente API universal. Faça perguntas em linguagem natural e obtenha dados ao vivo de milhares de APIs.

- **Equipes sem código** Nenhuma programação necessária. Conecte MCP, faça perguntas em linguagem natural e obtenha dados reais. Ideal para pesquisa, análise e prototipagem.

## Compatibilidade e configuração por cliente

O Zyla API Hub MCP usa transporte **Streamable HTTP (SSE)** — o servidor roda na nuvem, então você não precisa instalar Python, Node.js ou qualquer runtime local. Basta fornecer a URL.

|
Cliente |
Como conectar |
Transporte |
Dificuldade |

| Claude Code | Execute `claude mcp add` e cole a URL | stdio / http | Muito fácil |

| Claude Desktop | Edite o arquivo de configuração JSON e cole a URL | stdio / http | Fácil |

| OpenClaw | Execute `openclaw mcp add` e cole a URL | stdio / SSE | Muito fácil |

| Codex CLI | Execute `codex mcp add` e cole a URL | stdio / http | Muito fácil |

| Cursor | Edite `.cursor/mcp.json` no seu projeto | stdio | Fácil |

| Devin | Edite o arquivo de configuração JSON | stdio | Fácil |

| Cline (VS Code) | Edite o arquivo de configuração JSON | stdio | Fácil |

| ChatGPT | Configurações → Apps → Avançado → criar Conector com a URL | SSE / HTTP | Médio |

### Notas importantes

- **ChatGPT requer configuração manual** Diferente do Claude Code ou OpenClaw, você não pode simplesmente colar a linha MCP no chat do ChatGPT. Você precisa ir em **Configurações → Apps → Configurações Avançadas → Modo Desenvolvedor**, criar um novo Conector/App e colar a URL MCP do Zyla API Hub lá. Uma vez configurado, você pode usá-lo normalmente pelo chat.

- **Baseado na nuvem &mdash; sem runtime local necessário** O servidor MCP usa transporte SSE (Server-Sent Events), o que significa que roda inteiramente na nuvem. Você não precisa instalar Python, Node.js ou Docker na sua máquina. Seu agente de IA se conecta ao `mcp.zylalabs.com` como se estivesse visitando um site.

- **Mantenha sua chave API privada** O parâmetro `apikey=` na URL do MCP é sua credencial privada. Não compartilhe publicamente nem faça commit em repositórios públicos. Qualquer pessoa com sua chave pode usar seus créditos do Zyla API Hub. Se achar que sua chave foi exposta, rotacione-a na sua [página de chaves API](/api_keys).

## Perguntas frequentes

### Minha chave API é segura?

Sua chave é enviada por HTTPS e usada apenas para autenticar chamadas ao Zyla API Hub. Ela nunca é armazenada pelo servidor MCP — é passada em cada solicitação.

### Posso usar isso com qualquer API do Zyla?

Sim. Qualquer API listada no marketplace está disponível através do MCP. Seu agente a encontrará via `search_catalog` ou `list_categories`. Você não precisa assinar manualmente — quando seu agente chama uma API pela primeira vez, uma assinatura pague-conforme-usa é criada automaticamente.

### E se meu agente não conseguir conectar?

Certifique-se de que está usando a URL completa com sua chave API: `https://mcp.zylalabs.com/mcp?apikey=SUA_CHAVE`. Reinicie seu cliente de IA após salvar a configuração. Se o problema persistir, verifique se sua chave está ativa na sua [página de chaves API](/api_keys).

### Como isso é diferente de chamar APIs diretamente?

Com MCP, seu agente de IA cuida de tudo: encontrar a API certa, ler sua documentação, construir a solicitação e analisar a resposta. Você apenas faz uma pergunta em linguagem natural.

### Preciso assinar cada API antes de usá-la?

Não. Quando seu agente chama uma API que você ainda não usou, o Zyla API Hub cria automaticamente uma assinatura pague-conforme-usa para essa API. Você paga apenas pelo que usa — sem cadastro manual por API. Basta conectar MCP e começar a fazer perguntas.

### Onde posso obter minha chave API?

Você pode: (1) pedir ao agente de IA para usar a ferramenta `register` e criar uma conta com chave instantânea, ou (2) [criar uma conta no site](/register) e encontrar sua chave na [página de chaves API](/api_keys).

### Posso me registrar sem visitar o site?

Sim! Peça ao agente de IA para registrá-lo usando a ferramenta `register`. Forneça nome, email e senha. O agente receberá sua chave API imediatamente.

### Como adiciono um método de pagamento pelo agente de IA?

Peça ao agente para obter um link de pagamento (ele usará a ferramenta `get_payment_url`). Você receberá uma URL do Stripe Checkout — abra no navegador, adicione seu cartão e pronto.

### Meu agente pode explorar todas as 10,000+ APIs?

Sim. Use `browse_catalog` com paginação para explorar todas as APIs públicas. Filtre por categoria ou palavra-chave.

## Recursos

- [llms.txt](https://mcp.zylalabs.com/llms.txt): Catálogo conciso de APIs para LLMs

- [llms-full.txt](https://mcp.zylalabs.com/llms-full.txt): referência HTTP completa para agentes que não podem usar MCP (adicione ?apikey=YOUR_API_KEY)

- [Explorar todas as APIs](https://zylalabs.com/pt/api-marketplace): Explorar o marketplace completo

- [Especificação MCP](https://modelcontextprotocol.io): Documentação oficial do Model Context Protocol

---
Source: https://zylalabs.com/pt/docs/mcp
