Exemplos do Tunc SRC e prompts de configuração para agentes
Três configurações que funcionam com o Tunc SRC, cada uma com um prompt que o teu agente segue: guardar uma versão a cada alteração, retomar um projeto e voltar atrás.
Atualizado em
Cada configuração abaixo começa com um prompt que colas no teu agente, para que seja o agente a fazer o trabalho. Mantém as chaves de API fora dos prompts: entrega-as às tuas ferramentas como variáveis de ambiente ou segredos. A documentação do Tunc SRC tem todas as chamadas; esta página tem configurações que funcionam.
Deixa o teu agente ligar-se ao Tunc SRC
No Claude, o caminho mais rápido é uma ligação pré-preenchida. Abre Add custom connector com o nome e o URL já preenchidos; verifica e confirma.
Adicionar o Tunc SRC ao ClaudeO plano Free do Claude permite um conector personalizado. Nos planos Team e Enterprise, é um Owner que o adiciona.
No Claude Code, no Cursor ou em qualquer agente que consiga executar comandos ou alterar as suas próprias definições, cola isto. Ele adiciona a ligação, espera enquanto inicias sessão e depois testa-a:
Liga o Tunc SRC a esta sessão. O servidor MCP dele é https://mcp.tuncsrc.com/mcp. Se conseguires executar comandos, executa: claude mcp add --transport http tunc-src https://mcp.tuncsrc.com/mcp. Caso contrário, adiciona-o às minhas definições de MCP. Depois diz-me para iniciar sessão (no Claude Code: executa /mcp, escolhe tunc-src e depois Authenticate) e espera que eu confirme. Em seguida, testa: cria um projeto chamado connection-test, guarda um ficheiro hello.txt com o conteúdo “está a funcionar” e a frase “Teste de ligação.”, volta a ler o ficheiro e depois elimina o projeto. Diz-me o que fizeste e o que foi devolvido.No ChatGPT, ou em qualquer aplicação em que adicionas conectores através dos menus, pede ao agente que leia as instruções e te guie por elas:
Lê https://tuncsrc.com/llms.txt e diz-me, menu a menu, como ligar o Tunc SRC a esta aplicação. Usa a opção de início de sessão, não uma chave de API. Se esta aplicação precisar de um modo especial para adicionar conectores, diz-me qual.Um agente consegue adicionar a ligação, mas não consegue iniciar sessão por ti: autorizas uma vez no teu navegador e escolhes o que ele pode fazer. Os mesmos passos para cada cliente, se preferires fazê-lo à mão:
| Cliente | Passos |
|---|---|
| claude.ai, Claude Desktop and Claude mobile | Customize → Connectors → Add custom connector → nome Tunc SRC, URL https://mcp.tuncsrc.com/mcp → Add → Connect. O plano Free permite um conector personalizado; nos planos Team e Enterprise, é um Owner que o adiciona em Organization settings → Connectors. Esta ligação abre a caixa de diálogo com o nome e o URL já preenchidos: |
| Claude Code | Adiciona o servidor, depois executa /mcp, escolhe tunc-src e Authenticate. |
| ChatGPT | Settings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc SRC, URL https://mcp.tuncsrc.com/mcp, Authentication OAuth → Create → Connect. |
| Cursor | Adiciona-o ao ~/.cursor/mcp.json e depois vai a Settings → MCP: aparece “Needs login” → Login. |
| VS Code (Copilot) | Paleta de Comandos → MCP: Add Server → HTTP → https://mcp.tuncsrc.com/mcp → nome tunc-src → aceita o pedido de início de sessão. |
| Gemini CLI | Adiciona-o ao settings.json e depois executa /mcp auth tunc-src. |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → em URL, indica https://mcp.tuncsrc.com/mcp → em Authentication, escolhe OAuth 2.0, Dynamic discovery. |
Guarda um site no Tunc SRC, com uma versão depois de cada alteração
A tarefa: um assistente está a construir um site contigo (ou qualquer conjunto de ficheiros) ao longo de muitos chats, e queres guardar cada alteração para que nada se perca. A configuração: pede ao teu agente que crie um projeto no Tunc SRC e guarde uma versão depois de cada alteração.
Cria um projeto do Tunc SRC chamado my-site com src_repo (operation "create"). Guarda os ficheiros do site que temos até agora com src_write: cada ficheiro em changes com o path e o content dele, e um summary a dizer numa frase simples o que é esta versão. Daqui em diante, depois de cada alteração que eu aprovar, guarda uma versão nova com src_write, passando a versão mais recente como if_version, e diz-me com que frase a guardaste.Cada gravação é uma versão com uma frase. Se uma gravação for recusada com version_conflict, é porque alguém guardou entretanto: o agente lê o projeto de novo e refaz a alteração.
Retoma um projeto que outro assistente deixou
A tarefa: ontem um assistente trabalhou num projeto, e hoje estás noutra aplicação ou num chat novo. A configuração: o novo assistente lê o projeto e as versões dele no Tunc SRC, por isso parte do que foi mesmo guardado.
Lista os meus projetos do Tunc SRC com src_repo (operation "list"). Para o projeto my-site, lista as versões mais recentes com src_read (operation "versions") e diz-me quem guardou cada uma, quando e com que frase. Depois mostra-me o que a versão mais recente mudou com src_read (operation "changes", com version a apontar para essa versão), e lê a pasta raiz com src_read (operation "folder") para saberes o que o projeto contém.Vê com src_events o que aconteceu em my-site desde a última vez que olhámos, e guarda o valor next para voltares a perguntar a partir dali.A lista de versões diz quem guardou o quê e quando; src_events é um registo que se pode acompanhar. Não acorda um agente: é o agente que pergunta.
A última alteração estragou tudo: volta uma versão atrás
A tarefa: a alteração mais recente estragou o site e queres a versão anterior de volta. A configuração: o agente lista as versões e restaura a anterior, que é guardada como uma versão nova, por isso a versão estragada continua lá para ser examinada.
No projeto my-site do Tunc SRC, lista as versões com src_read (operation "versions") e mostra-me as duas mais recentes com as frases delas. Depois traz de volta a versão anterior à mais recente com src_write: passa essa versão em restore, a versão mais recente em if_version e o summary “Voltar à versão anterior à alteração que estragou o site.” Diz-me a nova versão quando estiver guardada.Restaurar nunca remove nada: os ficheiros da versão anterior são guardados como uma versão nova por cima das outras.
O mesmo projeto, também pelo git
As ferramentas são a forma de os agentes usarem o Tunc SRC. Se também usas git, o programa git de sempre trabalha com o mesmo projeto: um push e uma gravação feita por uma ferramenta ficam no mesmo histórico. Não há nada do Tunc para instalar.
Descreve o meu projeto my-site do Tunc SRC com src_repo (operation "describe") e dá-me o endereço que o programa git usa, para eu o poder clonar. Não mostres nenhuma chave de API.Convém saber
- Uma gravação leva até 1000 alterações de ficheiros e uma frase com até 500 caracteres. Um ficheiro guardado por uma ferramenta pode ter até 100 MiB, src_read não devolve inteiro um ficheiro com mais de 2 MiB, e um pedido de ferramenta aos hosts do Tunc SRC tem no máximo 12 MiB.
- Cada gravação indica a versão de que partiu (if_version). Uma versão desatualizada é recusada com version_conflict, por isso dois agentes não se sobrepõem um ao outro sem darem por isso.
- Um projeto guardado num espaço de trabalho é partilhado com os membros desse espaço de trabalho; um projeto guardado sem um é só teu.
- Eliminar um projeto remove todas as versões dele e não pode ser desfeito. Pede a um assistente que elimine só quando for mesmo isso que queres.
- A página da tua conta em https://tunchub.com/account mostra o teu armazenamento e os agentes ligados.
