---
title: "Testar com segurança (sandbox) · Zynko"
description: "Como testar bots, apps, agentes de IA e integrações com o Zynko sem afetar ninguém."
canonical: https://zynko.org/sandbox/
---

# Testar com segurança

O Zynko **não tem um ambiente de testes separado**: não existe um servidor de sandbox nem uma API de mentira. Bots, apps e agentes de IA usam a mesma API de produção, `https://zynko.org/api/v1`, com as mesmas regras e os mesmos limites. Tudo o que um teste faz acontece de verdade, então o jeito seguro é testar num canto só seu:

## 1. Um servidor só seu

Crie um servidor do tipo **Amigos** para os testes: é grátis e só entra quem você convidar. Não teste em comunidades públicas nem nos servidores de outras pessoas, e apague o servidor quando não precisar mais dele.

## 2. Um bot de testes

No portal [dev.zynko.org](https://dev.zynko.org), crie um bot só para testes e convide-o para o seu servidor. O token (`bot_` e 64 dígitos hexadecimais) aparece uma vez só: guarde numa variável de ambiente, como `ZYNKO_TOKEN`, nunca no código. Se ele vazar, gere outro no portal e o antigo para de funcionar na hora. O guia está em [Seu primeiro bot](https://docs.zynko.org/bots/primeiro-bot).

## 3. Apps e agentes com OAuth

Para testar um app ou agente que age por uma pessoa, registre um cliente público em `POST /api/v1/oauth/register` com um endereço de retorno de loopback, como `http://127.0.0.1/callback` (a porta pode mudar a cada execução), e autorize com a sua própria conta, pedindo só os escopos que for testar. Depois, desconecte o app em **Apps conectados**, nos ajustes do Zynko, ou revogue o token em `POST /api/v1/oauth/revoke`. O passo a passo, inclusive o registro de agentes que só conhecem o seu e-mail, está em [auth.md](https://zynko.org/auth.md) e em [OAuth para apps e agentes](https://docs.zynko.org/api/oauth).

## 4. Servidores MCP

O servidor MCP da documentação, `https://docs.zynko.org/mcp`, é público e só lê. O do produto, `https://zynko.org/mcp`, age de verdade na conta que você conectar: aponte o assistente para o seu servidor de testes e leia o que ele vai fazer antes de aprovar cada ferramenta. Para desenvolver bots, `npx -y zynko-mcp` roda no seu computador com o token do bot de testes.

## 5. Limites

São os de produção: 1200 requisições por minuto por token e 300 por minuto por endereço sem token, além dos limites de cada ação (por exemplo, 10 mensagens a cada 10 segundos por conta). Toda resposta da API traz os cabeçalhos `RateLimit-Policy` e `RateLimit`, e um `429` traz `Retry-After`. Para repetir uma escrita sem duplicar, mande o cabeçalho `Idempotency-Key`.

## Documentação

- [Visão geral da API](https://docs.zynko.org/api/): autenticação, erros, limites e versões.
- [OpenAPI 3.1](https://zynko.org/openapi.json) de todas as rotas, e o resumo para assistentes em [/api/llms.txt](https://zynko.org/api/llms.txt).
- [Bots com IA](https://docs.zynko.org/bots/ia): os servidores MCP e como configurar o Claude.

## In English

Zynko has no separate sandbox environment: tests run against the production API at https://zynko.org/api/v1, with the same rules and rate limits (1200 requests per minute per token, 300 per minute per address without one). To test safely, use a private server of your own (the free, invite-only Amigos kind) and a test bot created at dev.zynko.org; for OAuth, register a public client with a loopback redirect URI, authorize it with your own account and the fewest scopes, and disconnect it when you are done. The docs MCP server at https://docs.zynko.org/mcp is public and read-only; the product MCP server at https://zynko.org/mcp acts on the account you connect. Send an `Idempotency-Key` header to retry writes safely. See [auth.md](https://zynko.org/auth.md) and [the API docs](https://docs.zynko.org/api/).

[Sobre](https://zynko.org/sobre/) · [Termos](https://zynko.org/termos) · [Privacidade](https://zynko.org/privacidade) · [Suporte](https://zynko.org/suporte) · [Excluir conta](https://zynko.org/excluir-conta)
