TUNC.AI / Tunc Art 指南

从任何智能体上传文件并拿回一个私密链接

通过 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 mobileCustomize → Connectors → Add custom connector → 名称填 Tunc Art,URL 填 https://mcp.tuncart.com/mcp → Add → Connect。免费版只允许一个自定义连接器;Team 和 Enterprise 由 Owner 在 Organization settings → Connectors 里添加。这个链接会打开对话框,名称和 URL 已经填好:
https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Tunc%20Art&connectorUrl=https%3A%2F%2Fmcp.tuncart.com%2Fmcp
Claude Code先添加服务器,然后运行 /mcp,选择 tunc-art,再 Authenticate。
claude mcp add --transport http tunc-art https://mcp.tuncart.com/mcp
ChatGPTSettings → 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。
{
  "mcpServers": {
    "tunc-art": {
      "url": "https://mcp.tuncart.com/mcp"
    }
  }
}
VS Code (Copilot)命令面板 → MCP: Add Server → HTTP → https://mcp.tuncart.com/mcp → 名称 tunc-art → 允许登录提示。
Gemini CLI加到 settings.json,然后运行 /mcp auth tunc-art。
{
  "mcpServers": {
    "tunc-art": {
      "httpUrl": "https://mcp.tuncart.com/mcp"
    }
  }
}
Copilot StudioTools → 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 打开它,报告和它的笔记就在一起。