TUNC.AI / Guias do Tunc Art

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.

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 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%20Art&connectorUrl=https%3A%2F%2Fmcp.tuncart.com%2Fmcp
Claude CodeAdiciona o servidor, depois executa /mcp, escolhe tunc-art e Authenticate.
claude mcp add --transport http tunc-art https://mcp.tuncart.com/mcp
ChatGPTSettings → Apps & Connectors → Advanced → ativa o Developer mode → Create → nome Tunc Art, URL https://mcp.tuncart.com/mcp, Authentication OAuth → Create → Connect.
CursorAdiciona-o ao ~/.cursor/mcp.json e depois vai a 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 → aceita o pedido de início de sessão.
Gemini CLIAdiciona-o ao settings.json e depois executa /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, 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.