Carrega um ficheiro a partir de qualquer agente e recebe de volta uma ligação privada
Por MCP, A2A ou algumas chamadas REST: um agente guarda um relatório, uma imagem ou um PDF no Tunc Art e entrega-te a ligação privada.
Atualizado em
Três caminhos, um resultado: o ficheiro fica na tua conta Tunc e o agente devolve a sua ligação.
A partir de uma aplicação de IA, por MCP
Liga a aplicação a https://mcp.tuncart.com/mcp; ela inicia sessão com a tua conta Tunc no navegador. Depois pede: “Guarda este relatório no Tunc Art e dá-me a ligação.” O agente chama art_write. Os ficheiros até 8 MiB vão inline; os maiores, até 250 MiB, usam um carregamento pré-assinado.
| 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. |
A partir do teu próprio código, por REST
Cria uma chave de API em https://tunchub.com/account/keys/new com “Upload Tunc Art files” assinalado (as chaves criadas a partir do tuncart.com já vêm com esta opção ativada) e depois chama https://api.tuncart.com: inicia o carregamento, envia os bytes para o URL de carregamento e conclui-o.
# Files you can open (paged)
curl -s "https://api.tuncart.com/v1/files?limit=20" -H "Authorization: Bearer $TUNC_API_KEY"
# Upload: start, send the bytes to upload.url, then complete
curl -s https://api.tuncart.com/v1/files \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" \
-d '{"display_name":"q4-report.pdf","mime_type":"application/pdf","byte_count":482113}'
# → {"artifact":{"id":"…",…},"upload":{"method":"PUT","url":"…","headers":{…},…}}
curl -s https://api.tuncart.com/v1/files/<id>/complete \
-H "Authorization: Bearer $TUNC_API_KEY" \
-H "Content-Type: application/json" -d '{"byte_count":482113}'
# Download, and delete a file your key uploaded
curl -s https://api.tuncart.com/v1/files/<id>/content -H "Authorization: Bearer $TUNC_API_KEY" -o q4-report.pdf
curl -s -X DELETE https://api.tuncart.com/v1/files/<id> -H "Authorization: Bearer $TUNC_API_KEY"A partir de outro agente, por A2A
curl -s https://a2a.tuncart.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":"art_read","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"}],…}}}Guarda a ligação junto do trabalho
Os agentes ligados ao Tunc Orb podem guardar o artifact_id de um ficheiro num registo ({"artifact_id": "…"}) e abri-lo mais tarde com art_read, para que um relatório e as suas notas fiquem juntos.
