# Publique com seu agente de IA

Seu agente pode publicar e manter suas APIs para você. Ele se conecta ao servidor Zyla MCP com sua chave e usa as ferramentas `provider_*`, que chamam a [Listings API](https://zylalabs.com/pt/docs/listings-api). Qualquer conta com e-mail verificado pode usá-las.

O mesmo guia, com botões de cópia e sua chave já preenchida, está no seu dashboard: **Add new API → For AI agents**.

## 1. Obtenha sua chave de API

Copie-a em [Conectar agentes de IA (MCP)](https://zylalabs.com/pt/docs/mcp). Veja [Sua chave de API](https://zylalabs.com/pt/docs/api-keys).

## 2. Conecte o servidor MCP

Cole esta linha no seu agente:

```text
set up zyla with key YOUR_API_KEY - https://zylalabs.com/llms.txt
```

Ou adicione `https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY` como um servidor MCP remoto no seu cliente. Os detalhes de cada cliente estão em [Conectar agentes de IA (MCP)](https://zylalabs.com/pt/docs/mcp).

## 3. Peça para ele publicar

```text
Publique minha API no Zyla API Hub usando a ferramenta provider_upsert_listing.
Aqui está minha especificação OpenAPI / URL base: https://api.example.com/openapi.json
Nome: Example Weather API.
Adicione um endpoint por operação principal com uma resposta de exemplo real, proponha
planos e preços, e me mostre o payload antes de publicar.
```

## Ferramentas

| Ferramenta | O que faz |
|---|---|
| `provider_list_categories` | As categorias do marketplace (a Zyla define a categoria da sua API para você) |
| `provider_upsert_listing` | Cria ou atualiza um listing completo (`PUT /api/listings`) |
| `provider_get_listing` | Definição atual de um dos seus listings, para editá-lo |
| `provider_list_listings` | Seus listings com status e URL |
| `provider_delete_listing` | Exclui um listing; requer `confirm: true` |

## Bom saber

- O listing vai ao ar assim que passa pelas [regras de qualidade](https://zylalabs.com/pt/docs/quality-rules) e tem um endpoint com uma resposta de exemplo e planos ativos. Peça ao agente para enviar `"publish": false` para mantê-lo como rascunho.
- A [cota de novas APIs](https://zylalabs.com/pt/docs/quality-rules) se aplica, assim como na web.
- Seu segredo de origem (`access`) é armazenado de forma oculta e nunca é retornado ou registrado em log.
- Atualizar um listing não conta para a cota: peça ao agente para lê-lo com `provider_get_listing`, alterar o que você precisa e enviá-lo de volta.


---
Source: https://zylalabs.com/pt/docs/publish-with-agent