MCP

MCP

Połącz Claude, Cursor, VS Code, ChatGPT lub Grok, aby oznaczać i wykrywać pliki w obszarze, który należy do ciebie.

Wklej adres konektora w kliencie, który mówi MCP przez Streamable HTTP. Nie ma klucza API ani CLI do plików. Markedfile loguje cię tym samym kontem, w tym SSO i uwierzytelniaczem, a potem pyta, którego obszaru aplikacja może użyć.

Skonfiguruj połączenie

  1. 1Dodaj serwer MCP w kliencie i wybierz Streamable HTTP, czasem oznaczony jako HTTP.
  2. 2Wklej https://markedfile.com/api/mcp. Fragmenty poniżej to zwykłe miejsce, w którym każdy klient trzyma ten adres.
  3. 3Dokończ logowanie w przeglądarce i wybierz obszar.
  4. 4Zezwól na oznaczanie i wykrywanie. Połączenie cofniesz później w ustawieniach obszaru.

Jak działa logowanie

Połączenie używa OAuth 2.1 z PKCE (S256). Zatwierdzasz jeden obszar. Klient nie widzi hasła.

  1. 1Klient rejestruje się sam i wysyła wyzwanie kodu.
  2. 2Przeglądarka otwiera logowanie Markedfile. SSO i uwierzytelniacz to te, których konto już używa.
  3. 3Wybierasz obszar, który należy do ciebie, i zezwalasz na oznaczanie, wykrywanie albo oba.
  4. 4Markedfile zwraca jednorazowy kod na zarejestrowany adres powrotu. Klient wymienia go na token dostępu.
  5. 5Token dostępu trwa godzinę i jest przechowywany tylko jako skrót. Token odświeżania zmienia się przy każdym użyciu.
  6. 6Token może oznaczać i wykrywać tylko w wybranym obszarze. Plik oznaczony w innym obszarze nie zostanie rozpoznany.
  7. 7Cofnięcie połączenia unieważnia tokeny od razu.

Konfiguracja klienta

Użyj Streamable HTTP. Wybieraj file_url, gdy plik jest już publiczny. W przeciwnym razie wywołaj create_upload_url, wyślij surowe bajty przez PUT lub POST i przekaż file_id. Używaj file_base64 tylko dla bardzo małego pliku, około 100 KB.

Claude

  1. W claude.ai otwórz Ustawienia, potem Łączniki, i dodaj własny konektor. W Claude Desktop otwórz Ustawienia, potem Łączniki, i dodaj własny konektor.
  2. Wklej adres konektora. Pozwól klientowi dokończyć logowanie w przeglądarce.
  3. Zaloguj się w Markedfile, przez SSO lub uwierzytelniacz, jeśli konto ich używa, i wybierz obszar.

Claude

https://markedfile.com/api/mcp

Cursor

  1. Otwórz ustawienia Cursora, potem MCP, i dodaj serwer. Możesz też wstawić JSON poniżej do konfiguracji MCP.
  2. Wybierz Streamable HTTP i wklej adres konektora.
  3. Dokończ logowanie w przeglądarce i wybierz obszar. Cursor trzyma token odświeżania lokalnie.

Cursor

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

VS Code

  1. W VS Code uruchom MCP: Add Server z palety poleceń albo dodaj JSON poniżej w mcp.json.
  2. Ustaw typ na http, a URL na adres konektora.
  3. Dokończ logowanie w przeglądarce i wybierz obszar.

VS Code

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

ChatGPT

  1. W ChatGPT otwórz Ustawienia, a potem Łączniki. Tryb dewelopera też może dodać własny konektor albo aplikację.
  2. Dodaj adres konektora i rozpocznij logowanie.
  3. Zaloguj się w Markedfile i wybierz obszar.

ChatGPT

https://markedfile.com/api/mcp

Grok Bot

  1. W Grok Bot poproś bota na czacie, żeby dodał konektor z adresem poniżej.
  2. Zezwól na konto Markedfile na ekranie OAuth, który się otworzy.

Grok Bot

https://markedfile.com/api/mcp

Narzędzia

create_upload_url
Tworzy krótkotrwały adres przesyłania dla połączonego obszaru. Wyślij surowe bajty pliku na upload_url przez PUT albo POST. curl może użyć --upload-file albo --data-binary. Potem przekaż file_id do mark_file albo detect_file. Adres działa około 15 minut. max_bytes to limit planu obszaru, łącznie z wideo. To nie oznacza pliku i nie zajmuje miejsca aktywnego pliku.
mark_file
Oznacza jeden plik dla jednego odbiorcy w połączonym obszarze. Wybieraj file_id z create_upload_url albo file_url, gdy plik jest już publiczny. Wysyłaj file_base64 tylko dla bardzo małego pliku, około 100 KB. Wyślij dokładnie jedno z: file_id, file_url albo file_base64. recipient albo label to identyfikator (1–32 znaki, bez znaków sterujących). Oznaczony plik wraca jako download_url, krótkotrwały link. Ustaw inline_base64 na true tylko wtedy, gdy oznaczony plik ma około 100 KB lub mniej i bajty muszą być w wyniku. Wideo trafia do kolejki: wynik to id zadania i statusUrl, nie oznaczone bajty.
detect_file
Sprawdza jeden plik względem połączonego obszaru. Wybieraj file_id z create_upload_url albo file_url, gdy plik jest już publiczny. Wysyłaj file_base64 tylko dla bardzo małego pliku, około 100 KB. Wyślij dokładnie jedno z: file_id, file_url albo file_base64. Zwraca identyfikator odbiorcy, gdy oznaczenie należy do tego obszaru. Wideo trafia do kolejki: odpytuj statusUrl, aż pojawi się result. Zrzut jednej klatki nie jest wykrywany jako obraz.

Limity

Oznaczanie pozwala na 40 żądań na minutę, wykrywanie na 80, a create_upload_url na 30, dla konta. Rozmiar pliku, strony PDF i wideo wynikają z planu obszaru. Adres przesyłania wygasa po około 15 minutach, a adres pobrania oznaczonego pliku po około godzinie. Żaden z nich nie jest aktywnym plikiem.