MCP · Markedfile

MCP

连接 Claude、Cursor、VS Code、ChatGPT 或 Grok，在你拥有的工作区里标记并检测文件。

把连接器网址粘贴到通过 Streamable HTTP 使用 MCP 的客户端。没有 API 密钥，也没有文件命令行工具。Markedfile 会用同一个账户登录，包括 SSO 和验证器，然后询问应用可以使用哪个工作区。

设置连接

连接使用 OAuth 2.1 和 PKCE（S256）。你批准一个工作区。客户端看不到你的密码。

使用 Streamable HTTP。文件已经公开时，优先用 file_url。否则调用 create_upload_url，用 PUT 或 POST 发送原始字节，再传入 file_id。file_base64 只用于大约 100 KB 以内的很小文件。

https://markedfile.com/api/mcp

{
  "mcpServers": {
    "markedfile": {
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

{
  "servers": {
    "markedfile": {
      "type": "http",
      "url": "https://markedfile.com/api/mcp"
    }
  }
}

https://markedfile.com/api/mcp

https://markedfile.com/api/mcp

create_upload_url: 为已连接的工作区建立短时上传网址。用 PUT 或 POST 把文件的原始字节发到 upload_url。curl 可以用 --upload-file 或 --data-binary。然后把 file_id 传给 mark_file 或 detect_file。网址大约维持 15 分钟。max_bytes 是工作区方案上限，包含视频。这不会标记文件，也不占用使用中的文件名额。
mark_file: 在已连接的工作区，为一个接收者标记一个文件。优先使用 create_upload_url 的 file_id，或文件已经公开时的 file_url。file_base64 只发送大约 100 KB 以内的很小文件。file_id、file_url、file_base64 只能发送其中一个。recipient 或 label 是标识（1–32 个字符，不含控制字符）。标记后的文件以 download_url 返回，这是短时链接。只有标记后的文件大约 100 KB 或更小，而且结果里必须带字节时，才把 inline_base64 设为 true。视频会排队：结果是任务 id 和 statusUrl，不是已标记的字节。
detect_file: 把一个文件和已连接的工作区比对。优先使用 create_upload_url 的 file_id，或文件已经公开时的 file_url。file_base64 只发送大约 100 KB 以内的很小文件。file_id、file_url、file_base64 只能发送其中一个。标记属于该工作区时，会返回接收者的标识。视频会排队：轮询 statusUrl，直到出现 result。单帧的屏幕截图不会被当成图片检测。

标记每分钟 40 次请求，检测 80 次，create_upload_url 30 次，按账户计算。文件大小、PDF 页数和视频遵循工作区方案。上传网址大约 15 分钟后失效，已标记文件的下载网址大约一小时后失效。两者都不是使用中的文件。