English

Połącz CVersum ze swoim agentem AI

Asystent loguje się na Twoje konto CVersum przez OAuth i pracuje tylko na Twoich CV. MCP jest na każdym planie, także darmowym. Dopasowanie CV do oferty kosztuje 1 kredyt AI, tak jak w serwisie. Import zużywa dzienny limit funkcji AI.

Adres serwera

https://cversum.pl/api/mcp

Ten sam serwer jest też pod adresem https://cversum.pl/mcp (alias, bez przekierowania).

Logowanie

Po podaniu adresu klient otworzy zwykłe logowanie CVersum (to samo co na stronie) i ekran zgody. Zatwierdzasz dostęp do odczytu i zapisu CV. Hasła nie wpisujesz w czacie.

Jak podłączyć

Claude (claude.ai i Claude Desktop)

Według pomocy Claude: Customize → Connectors → Add → Custom → Web (albo „Add custom connector”). Nazwa: CVersum. Adres: https://cversum.pl/api/mcp. Uwierzytelnianie: Sign in now albo Sign in when needed. Klient OAuth: „Use Claude’s published identity” albo „Register automatically”. Potem zaloguj się na CVersum i zatwierdź dostęp.

Na planach Team i Enterprise łącznik najpierw dodaje właściciel organizacji (Organization settings → Connectors). Członkowie łączą się później z Customize → Connectors. Claude Desktop używa tego samego łącznika: Anthropic łączy się ze swojego serwera, nie z lokalnego pliku JSON.

Otwórz okno dodawania łącznika w Claude z uzupełnioną nazwą i adresem.

ChatGPT

Według dokumentacji OpenAI: na chatgpt.com otwórz Plugins, wybierz plus, potem Add custom MCP server. Nazwa: CVersum. Adres: https://cversum.pl/api/mcp. Uwierzytelnianie: OAuth. Potwierdź ostrzeżenie i utwórz wtyczkę. ChatGPT otworzy logowanie CVersum.

Na planach Business, Enterprise i Edu administrator decyduje, kto może dodawać własne serwery MCP (pomoc OpenAI). Starszy ekran administratora może nadal nazywać to Developer mode. Jeśli nie widzisz „Add custom MCP server”, ten plan albo workspace nie daje własnych łączników MCP.

Gemini

Aplikacja Gemini w przeglądarce i na telefonie nie opisuje dodawania własnego zdalnego serwera MCP. Zdalny MCP jest w Gemini CLI, które samo wykrywa OAuth i otwiera przeglądarkę:

gemini mcp add --transport http cversum https://cversum.pl/api/mcp

Albo w ~/.gemini/settings.json ustaw httpUrl na ten adres. Po 401 CLI przeprowadzi logowanie CVersum.

Grok

Według dokumentacji Grok: grok.com/connectors → New Connector → Custom. Wklej https://cversum.pl/api/mcp i dokończ logowanie CVersum. Serwer musi być publiczny.

W Grok CLI, według dokumentacji MCP, OAuth też idzie przez przeglądarkę:

grok mcp add --transport http cversum https://cversum.pl/api/mcp

W API Grok możesz zamiast OAuth podać osobisty token w nagłówku Authorization (Remote MCP Tools).

Cursor i inne klienty

W Cursor: Settings → MCP → nowy serwer zdalny, transport HTTP, adres https://cversum.pl/api/mcp. Gdy pojawi się przeglądarka, zaloguj się na CVersum. Inny klient ze Streamable HTTP i OAuth 2.1 (PKCE) używa tego samego adresu. Odkrycie serwera jest w /.well-known/oauth-protected-resource.

Narzędzia

  • list_cvs — Lista CV: id, nazwa, język, data aktualizacji i link do edycji.
  • import_cv — Import CV z PDF, DOCX, TXT, PNG lub JPG (plik base64 albo adres https).
  • tailor_cv — Nowe CV pod ofertę: stanowisko, firma, CV bazowe, śmiałość 1–5 (tylko sformułowania), treść ogłoszenia do 15 000 znaków. Domyślnie tylko fakty z bazy (facts_only). idempotency_key powtarza żądanie bez drugiego CV i kredytu. Koszt: 1 kredyt.
  • export_cv_pdf — Eksport do PDF, jedynego formatu eksportu. Zwraca krótki link do pobrania.
  • rename_cv — Zmiana nazwy CV.
  • set_cv_photo — Zdjęcie CV: zdjęcie konta, adres https albo base64. Dokładnie jedno źródło.
  • set_position_logo — Logo firmy ze wspólnej bazy. Brakujące logo dodajesz z adresu albo domeny, bez drugiego pliku o tej samej nazwie.
  • list_templates — Szablony: Klasyczny, Nowoczesny, Elegancki, Minimalistyczny, Kreatywny. Układy: two-column i single-column.
  • set_cv_template_layout — Ustawia szablon i układ CV, także single-column.

Nie ma narzędzia do usuwania CV.

Przykładowe polecenia

  • Pokaż moje CV w CVersum.
  • Zaimportuj CV z tego adresu: https://example.com/moje-cv.pdf
  • Dopasuj moje CV do stanowiska Analityk w firmie Przykład, śmiałość 3. Oto ogłoszenie: …
  • Pobierz PDF tego CV.
  • Zmień nazwę tego CV na Analityk — Przykład.
  • Ustaw zdjęcie konta na tym CV.
  • Dodaj logo Samsung do stanowiska w tym CV.
  • Ustaw szablon Kreatywny i układ jednokolumnowy.

Cofnięcie dostępu

Ustawienia konta → Połączenia. Odłącz aplikację albo unieważnij token. Działa od razu. Połączenia.

Token osobisty

Do skryptów i REST API utwórz token w Połączeniach. Pokazujemy go tylko raz. Nagłówek: Authorization: Bearer cvsk_… Dokumentacja żądań: Dokumentacja API.