Documentação

Como usar Forkly

Guia prático pra entender o que o Forkly faz, como instalar e como aproveitar cada feature. Pra contexto de produto, veja a landing.

Vercel, Supabase e MCP

Integrações nativas

O painel Integrações (tab strip lateral direita) conecta Vercel e Supabase por PAT (Personal Access Token) — sem CLI, sem OAuth de Marketplace. Tokens ficam no safeStorage do sistema operacional, isolados por projeto.

Vercel
Deploy preview / produção (com confirm), listar e editar env vars por target, ver logs do último deploy, refresh de status.
Supabase
Browse tables com sidebar de schemas colapsáveis, editar linha inline, editor SQL com confirm em queries destrutivas, deploy de edge functions, migrations versionadas via API (compatível com supabase db push).

As mesmas ações estão expostas como MCP tools — agentes operam Vercel e Supabase sozinhos. Você pede "sobe a edge function de pagamento" e o Task executa direto, sem você sair do chat. PATs nunca vazam pros agents.

Abaixo, no mesmo painel, fica Ferramentas dos agentes (MCP): o que os agentes deste projeto podem usar além do Forkly. Hoje o catálogo traz Linear, GitHub e Sentry, com o fluxo de conexão guiado — você clica em conectar e o Forkly registra o servidor e abre a autorização. Não precisa achar endpoint nem editar arquivo de config.

A conexão vale só neste projeto
Conectar o Linear num cliente não expõe o Linear nos outros. A exceção é o codex, que não tem escopo de projeto: nele a conexão é da máquina inteira, e a tela avisa isso.
Cada CLI guarda o login dele
Conectar no claude não conecta no codex. O agente só enxerga a ferramenta no CLI em que ele roda — por isso o card mostra o estado separado por CLI. Dá para conectar em claude, codex, cursor, copilot e opencode.
Ligar por projeto é outra coisa
Conectar disponibiliza a ferramenta; a caixa de seleção decide se ela entra nos agentesdeste projeto. Nenhuma ligada = os agentes rodam só com as ferramentas do Forkly.
Nos CLIs sem escopo próprio (cursor, copilot, opencode) o registro é um arquivo dentro do repositório — .cursor/mcp.json, .github/mcp.json ou opencode.json. É onde eles leem. Ao conectar, o Forkly já acrescenta esse arquivo ao .gitignore, para a integração não virar commit.