从任何智能体上传文件并拿回一个私密链接
通过 MCP、A2A 或几次 REST 调用:智能体把报告、图片或 PDF 存进 Tunc Art,并把它的私密链接交给你。
更新于
三种入口,一个结果:文件在你的 Tunc 账号里,智能体返回它的链接。
从 AI 应用里,通过 MCP
把应用接到 https://mcp.tuncart.com/mcp;它会在浏览器里用你的 Tunc 账号登录。然后说:“把这份报告存到 Tunc Art,把链接给我。”智能体会调用 art_write。不超过 8 MiB 的文件直接内联发送;更大的(最大 250 MiB)使用预签名上传。
| 客户端 | 步骤 |
|---|---|
| claude.ai, Claude Desktop and Claude mobile | Customize → Connectors → Add custom connector → 名称填 Tunc Art,URL 填 https://mcp.tuncart.com/mcp → Add → Connect。免费版只允许一个自定义连接器;Team 和 Enterprise 由 Owner 在 Organization settings → Connectors 里添加。这个链接会打开对话框,名称和 URL 已经填好: |
| Claude Code | 先添加服务器,然后运行 /mcp,选择 tunc-art,再 Authenticate。 |
| ChatGPT | Settings → Apps & Connectors → Advanced → 打开 Developer mode → Create → 名称填 Tunc Art,URL 填 https://mcp.tuncart.com/mcp,Authentication 选 OAuth → Create → Connect。 |
| Cursor | 加到 ~/.cursor/mcp.json,然后 Settings → MCP:会显示“Needs login” → Login。 |
| VS Code (Copilot) | 命令面板 → MCP: Add Server → HTTP → https://mcp.tuncart.com/mcp → 名称 tunc-art → 允许登录提示。 |
| Gemini CLI | 加到 settings.json,然后运行 /mcp auth tunc-art。 |
| Copilot Studio | Tools → Add a tool → New tool → Model Context Protocol → URL 填 https://mcp.tuncart.com/mcp → Authentication 选 OAuth 2.0,Dynamic discovery。 |
在你自己的代码里,通过 REST
在 https://tunchub.com/account/keys/new 创建一个勾选了“上传 Tunc Art 文件”的 API 密钥(从 tuncart.com 创建的密钥默认就勾上),然后调用 https://api.tuncart.com:开始上传,把字节发到上传地址,完成上传。
# 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"从另一个智能体,通过 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"}],…}}}把链接和工作放在一起
连接到 Tunc Orb 的智能体可以把文件的 artifact_id 存进一条记录({"artifact_id": "…"}),之后用 art_read 打开它,报告和它的笔记就在一起。
