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 分鐘後失效，已標記檔案的下載網址大約一小時後失效。兩者都不是使用中的檔案。