Exemplos do Tunc Art e prompts de configuração para agentes
Três configurações prontas para o Tunc Art, cada uma com um prompt que o teu agente segue: um relatório como uma ligação privada, encontrar e ler ficheiros guardados, e carregamentos por script.
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 Art tem todas as chamadas; esta página tem configurações que funcionam.
Deixa o teu agente ligar-se ao Tunc Art
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 Art 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 Art a esta sessão. O servidor MCP dele é https://mcp.tuncart.com/mcp. Se conseguires executar comandos, executa: claude mcp add --transport http tunc-art https://mcp.tuncart.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-art e depois Authenticate) e espera que eu confirme. Em seguida, testa: guarda um ficheiro de texto chamado test-hello.txt com o conteúdo “está a funcionar”, abre-o e depois elimina-o. 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://tuncart.com/llms.txt e diz-me, menu a menu, como ligar o Tunc Art 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 Art, URL https://mcp.tuncart.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-art e Authenticate. |
| ChatGPT | Settings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc Art, URL https://mcp.tuncart.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.tuncart.com/mcp → nome tunc-art → aceita o pedido de início de sessão. |
| Gemini CLI | Adiciona-o ao settings.json e depois executa /mcp auth tunc-art. |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → em URL, indica https://mcp.tuncart.com/mcp → em Authentication, escolhe OAuth 2.0, Dynamic discovery. |
Envia um relatório finalizado como uma única ligação privada
O problema: um assistente criou algo que as pessoas precisam de ler, e um anexo não é prático. A configuração: pede o ficheiro e a ligação. A ligação é privada para ti, e és tu que decides quem mais entra.
Escreve um resumo de uma página desta conversa e guarda-o no Tunc Art como 2026-10-project-summary.md (ou como PDF, se conseguires gerar um). Dá-me a ligação e diz-me quando expira.Abres a ligação com sessão iniciada na tua conta Tunc, e as pessoas com quem partilhas o ficheiro através de um espaço de trabalho Tunc também. Para o enviares a alguém fora da tua conta, abre a página do ficheiro e define uma palavra-passe de partilha: a pessoa abre a ligação, introduz a palavra-passe e vê o ficheiro durante 30 minutos de cada vez. Um assistente não consegue ativar a partilha; só tu consegues. Uma palavra-passe é válida durante 7 dias, no máximo, ou até o ficheiro expirar, por isso define-a de novo para prolongar o prazo.
Dá aos ficheiros nomes com a data e o assunto, como acima. O Tunc Art guarda cada ficheiro que guardas em vez de o substituir, por isso uma nova versão é um novo ficheiro, e os mais antigos expiram sozinhos.
Encontra, lê e reaproveita o que os teus assistentes guardaram
O problema: o relatório do mês passado, o PDF de um contrato ou uma folha de cálculo está no Tunc Art e queres uma resposta a partir dele, não uma transferência. A configuração: pede com palavras simples. O assistente lista, filtra e abre ficheiros. Vê imagens como imagens, PDF como imagens das páginas (quatro de cada vez), Word, PowerPoint e e-mail como texto, folhas de cálculo por folha e intervalo, e ficheiros comprimidos um item de cada vez.
Lista os meus ficheiros do Tunc Art dos últimos 7 dias, dos mais recentes para os mais antigos.Encontra o livro do 3.º trimestre no Tunc Art (se mais do que um corresponder, lista-os e pergunta qual) e resume a folha Revenue, células A1 a F40.Encontra o PDF do contrato que guardei no Tunc Art no mês passado (se mais do que um puder ser ele, lista-os e pergunta qual). Lê-o quatro páginas de cada vez até encontrares o que diz sobre a rescisão, e para ao fim de 40 páginas para me perguntar.Encontra as imagens que guardei no Tunc Art este mês e diz-me quantas são. Se forem 20 ou menos, descreve cada uma numa linha.O assistente pode restringir uma pesquisa por nome, por tipo (image, pdf, workbook, presentation, document e outros), por datas de criação posteriores e anteriores e pela ordem: newest, oldest, name ou largest.
Publica a partir de um script ou de um build
O problema: uma exportação noturna, uma execução de testes ou um build produz um relatório que ninguém encontra. A configuração: o trabalho carrega-o no Tunc Art com uma chave de API e imprime o id do ficheiro; pedes a um assistente que leia o mais recente.
Cria em https://tunchub.com/account/keys/new?product=art uma chave de API só com o acesso de que precisa (abrir e carregar ficheiros do Tunc Art) e guarda-a como segredo no teu CI ou agendador. Depois cola isto no teu agente de programação:
Adiciona ao meu pipeline de CI um passo que carregue build/report.pdf no Tunc Art através de https://api.tuncart.com/v1/files: inicia o carregamento com o nome, o tipo e o tamanho do ficheiro, faz PUT dos bytes no URL de carregamento devolvido e depois conclui o carregamento. Lê a chave de API do segredo TUNC_API_KEY e nunca a imprimas. Imprime o id do ficheiro quando correr bem. Usa https://tuncart.com/docs para o formato dos pedidos.Depois, pergunta a qualquer assistente ligado:
Abre o ficheiro mais recente no Tunc Art cujo nome contenha “report” e diz-me que verificações falharam. Se for um PDF, lê todas as páginas.Guarda o id de um ficheiro junto das tuas notas
O Tunc Orb guarda notas para os teus assistentes. Regista lá o artifact_id de um ficheiro e qualquer assistente consegue abrir o ficheiro mais tarde: o id abre-o, enquanto a ligação é só para pessoas. Isto exige que ambos estejam ligados.
Guarda este relatório no Tunc Art como 2026-10-weekly-report.pdf. Depois atualiza o registo reports/latest do Tunc Orb com o artifact_id do ficheiro, o nome, quando expira e a data de hoje, e dá-me a ligação.Convém saber
- Os ficheiros são mantidos durante 30 dias no plano gratuito e 365 dias com armazenamento pago, e cada ficheiro mostra a data de fim. Quando o armazenamento está cheio, os ficheiros mais antigos são removidos primeiro e a tua conta lista o que foi removido.
- Um ficheiro pode ter até 250 MiB. Os assistentes enviam até 8 MiB inline e os ficheiros maiores através de um URL de carregamento, o que o teu assistente faz por ti.
- Eliminar um ficheiro corta de imediato a sua ligação e não pode ser anulado. Pede a um assistente que elimine apenas quando é isso que queres.
- A página da tua conta em https://tunchub.com/account mostra o que está armazenado e que agentes estão ligados.
