TUNC.AI / Guias do Tunc Art

Envie um arquivo de qualquer agente e receba de volta um link privado

Por MCP, A2A ou algumas chamadas REST: um agente salva um relatório, uma imagem ou um PDF no Tunc Art e entrega a você o link privado.

Atualizado em

Três caminhos, um resultado: o arquivo fica na sua conta Tunc e o agente devolve o link dele.

De um app de IA, por MCP

Conecte o app a https://mcp.tuncart.com/mcp; ele entra com a sua conta Tunc no navegador. Depois peça: “Salve este relatório no Tunc Art e me dê o link.” O agente chama art_write. Arquivos de até 8 MiB vão inline; os maiores, de até 250 MiB, usam um upload pré-assinado.

ClientePassos
claude.ai, Claude Desktop and Claude mobileCustomize → 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 o adiciona em Organization settings → Connectors. Este link abre a caixa de diálogo com o nome e a URL já preenchidos:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Art&connectorUrl=https%3A%2F%2Fmcp.tuncart.com%2Fmcp
Claude CodeAdicione o servidor, depois execute /mcp, escolha tunc-art e Authenticate.
claude mcp add --transport http tunc-art https://mcp.tuncart.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ative o Developer mode → Create → nome Tunc Art, URL https://mcp.tuncart.com/mcp, Authentication OAuth → Create → Connect.
CursorAdicione-o ao ~/.cursor/mcp.json e depois vá em Settings → MCP: aparece “Needs login” → Login.
{
  "mcpServers": {
    "tunc-art": {
      "url": "https://mcp.tuncart.com/mcp"
    }
  }
}
VS Code (Copilot)Paleta de Comandos → MCP: Add Server → HTTP → https://mcp.tuncart.com/mcp → nome tunc-art → permita o pedido de login.
Gemini CLIAdicione-o ao settings.json e depois execute /mcp auth tunc-art.
{
  "mcpServers": {
    "tunc-art": {
      "httpUrl": "https://mcp.tuncart.com/mcp"
    }
  }
}
Copilot StudioTools → Add a tool → New tool → Model Context Protocol → em URL, informe https://mcp.tuncart.com/mcp → em Authentication, escolha OAuth 2.0, Dynamic discovery.

Do seu próprio código, por REST

Crie uma chave de API em https://tunchub.com/account/keys/new com “Upload Tunc Art files” marcado (chaves criadas a partir do tuncart.com já vêm com essa opção ativada) e depois chame https://api.tuncart.com: inicie o upload, envie os bytes para a URL de upload e conclua.

# 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"

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"}],…}}}

Agentes conectados ao Tunc Orb podem guardar o artifact_id de um arquivo em um registro ({"artifact_id": "…"}) e abri-lo depois com art_read, para que um relatório e suas anotações fiquem juntos.