TUNC.AI / Guias do Tunc SRC

Dá controlo de versões aos teus agentes de IA sem aprender git

Liga o Claude, o ChatGPT, o Cursor ou o teu próprio código ao Tunc SRC: os agentes guardam os teus projetos e cada versão, com palavras simples.

Atualizado em

Um agente que constrói um site ou uma ferramenta contigo ao longo de muitos chats precisa de um sítio para guardar os ficheiros, e de um caminho de volta quando uma alteração corre mal. É para isso que serve o controlo de versões, mas costuma pedir uma cópia local, uma linha de comandos e palavras como commit e branch. O Tunc SRC é controlo de versões feito para agentes: cinco ferramentas, uma chamada cada, e palavras simples. Um projeto guarda os teus ficheiros, uma versão é uma gravação, e quem guarda é o agente.

1. Liga a tua aplicação de IA por MCP

Liga o teu assistente a https://mcp.tuncsrc.com/mcp e inicia sessão com a tua conta Tunc no navegador. No Tunc Hub, as mesmas cinco ferramentas já vêm integradas.

ClientePassos
claude.ai, Claude Desktop and Claude mobileCustomize → 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:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20SRC&connectorUrl=https%3A%2F%2Fmcp.tuncsrc.com%2Fmcp
Claude CodeAdiciona o servidor, depois executa /mcp, escolhe tunc-src e Authenticate.
claude mcp add --transport http tunc-src https://mcp.tuncsrc.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc SRC, URL https://mcp.tuncsrc.com/mcp, Authentication OAuth → Create → Connect.
CursorAdiciona-o ao ~/.cursor/mcp.json e depois vai a Settings → MCP: aparece “Needs login” → Login.
{
  "mcpServers": {
    "tunc-src": {
      "url": "https://mcp.tuncsrc.com/mcp"
    }
  }
}
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 CLIAdiciona-o ao settings.json e depois executa /mcp auth tunc-src.
{
  "mcpServers": {
    "tunc-src": {
      "httpUrl": "https://mcp.tuncsrc.com/mcp"
    }
  }
}
Copilot StudioTools → Add a tool → New tool → Model Context Protocol → em URL, indica https://mcp.tuncsrc.com/mcp → em Authentication, escolhe OAuth 2.0, Dynamic discovery.

2. Pede com palavras simples

  • “Guarda este site no Tunc SRC e guarda uma versão depois de cada alteração.” O agente cria um projeto com src_repo e guarda com src_write: os ficheiros alterados e uma frase a dizer o que mudou.
  • “O que mudou desde ontem?” O agente lista as versões com src_read: quem guardou cada uma, quando e com que frase.
  • “A última alteração estragou tudo, volta uma versão atrás.” O agente restaura a versão anterior com src_write. É guardada como uma versão nova, por isso nada se perde.

3. Vários agentes, um só projeto

Cada gravação indica a versão de que partiu. Se outro agente guardou entretanto, a gravação é recusada com version_conflict, e o agente lê de novo e refaz a alteração, por isso dois agentes não se sobrepõem um ao outro sem darem por isso. src_events diz o que aconteceu num projeto a partir de uma posição, para que um agente se ponha a par antes de começar.

A partir do teu próprio código, por REST ou A2A

Os agentes usam o Tunc SRC de forma nativa por MCP e A2A. Para scripts e para o teu próprio software, cria uma chave de API em https://tunchub.com/account/keys/new e chama https://api.tuncsrc.com/v1/tool com o nome de uma ferramenta e os argumentos dela:

# Your projects, each with its latest version
curl -s https://api.tuncsrc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"src_repo","arguments":{"operation":"list"}}'

# Create a project, then save two files as its first version
curl -s https://api.tuncsrc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"src_repo","arguments":{"operation":"create","project":"my-site"}}'
curl -s https://api.tuncsrc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"src_write","arguments":{"project":"my-site",
       "summary":"First version of the home page.",
       "changes":[{"path":"index.html","content":"<h1>Hello</h1>"},
                  {"path":"css/site.css","content":"h1 { color: teal; }"}]}}'

# Every later save names the version it started from (if_version);
# a stale one is refused with version_conflict: read again and redo the change
curl -s https://api.tuncsrc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"src_write","arguments":{"project":"my-site",
       "summary":"Say hello to visitors by name.","if_version":"<version>",
       "changes":[{"path":"index.html","content":"<h1>Hello, visitor</h1>"}]}}'

# The saved versions, newest first
curl -s https://api.tuncsrc.com/v1/tool \
  -H "Authorization: Bearer $TUNC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"src_read","arguments":{"project":"my-site","operation":"versions"}}'

Ou chama o agente A2A 1.0:

curl -s https://a2a.tuncsrc.com -H "Authorization: Bearer $TUNC_API_KEY" -H 'A2A-Version: 1.0' \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"SendMessage","params":{"message":{
        "messageId":"m-1","role":"ROLE_USER",
        "parts":[{"data":{"skill":"src_repo","arguments":{"operation":"list"}},"mediaType":"application/json"}]}}}'
# → {"jsonrpc":"2.0","id":1,"result":{"message":{"role":"ROLE_AGENT",
#      "parts":[{"data":{…the tool's result…},"mediaType":"application/json"}],…}}}

Mantém o controlo

Cada aplicação ligada e cada chave de API aparecem em Agents & keys na tua conta (https://tunchub.com/account?tab=agents). Restringe um agente a só leitura ou desliga-o quando quiseres; um agente desligado é recusado em menos de um minuto.

Grátis: 1 GB de armazenamento partilhado pelo Tunc Hub, Tunc Art, Tunc Doc, Tunc Orb e Tunc SRC.