Rejestruj czas z Claude Code i Cursora przez serwer MCP Sandtime.io

Najlepszy moment na zapisanie czasu to chwila, w której przestajesz pisać, a dla programisty ta chwila zdarza się w edytorze albo w terminalu, nie w aplikacji do rejestracji czasu. Sandtime.io udostępnia serwer MCP, więc Claude Code, Cursor, Claude Desktop, Codex i każdy inny klient Model Context Protocol może tworzyć, odczytywać i poprawiać wpisy czasu za Ciebie, w zwykłym języku. Oto co robi, jak podłączyć go jedną komendą i jak wygląda prawdziwe polecenie od początku do końca.

Dlaczego rejestracja czasu należy do sesji kodowania

Programiści nie zapominają rejestrować czasu z niedbalstwa. Zapominają, bo narzędzie mieszka w karcie przeglądarki oddalonej o trzy przełączenia kontekstu od terminala, a zanim karta się otworzy, praca zdążyła już zlać się z kolejnym zadaniem. Arkusze na koniec miesiąca są potem odtwarzane z historii gita i kalendarza, co jest powolne i nigdy do końca prawdziwe.

Asystent, który już siedzi w sesji, zmienia geometrię. Kontekst jest na miejscu: które repozytorium, który ticket, mniej więcej ile czasu. Powiedzenie „zapisz to jako dwie godziny na migrację API” nic nie kosztuje, a wpis ląduje z właściwym projektem, właściwym dniem oraz godziną rozpoczęcia i zakończenia, które nie kolidują z niczym, co już zapisałeś.

Model Context Protocol to hydraulika, która to umożliwia. Serwer MCP udostępnia narzędzia, które klient taki jak Claude Code czy Cursor może wywoływać w Twoim imieniu. Serwer Sandtime.io udostępnia rejestrację czasu jako takie narzędzia, przez Streamable HTTP, z tymi samymi uprawnieniami, które Twoje konto ma w aplikacji.

Co potrafi serwer

Pełna lista, z parametrami każdego narzędzia, jest na stronie serwera MCP. Te, które liczą się w sesji kodowania:

• Wpisy czasu: create_activity, update_activity, delete_activity, stop_activity i list_activities dla zakresu dat, plus fill_activities do wypełnienia całego tygodnia według wzorca.
• Projekty i osoby: list_projects, get_project, list_project_members, get_current_user.
• Stan arkusza: get_timesheet_status, lock_timesheet, unlock_timesheet, request_timesheet_unlock oraz narzędzia do zatwierdzania i odrzucania próśb o odblokowanie.
• Raporty: get_time_summary do szybkich sum, create_report i list_reports do tych samych raportów, które buduje aplikacja webowa.
• Kalendarz: get_calendar zwraca dni robocze i święta Twojej organizacji, więc „wypełnij zeszły tydzień, pomiń święto” działa bez nazywania święta.

Każdy zapis przechodzi przez to samo wykrywanie nakładających się wpisów, co aplikacja. Jeśli wpis, o który prosisz, koliduje z już istniejącym, serwer zwraca konflikty, a asystent mówi Ci o tym, zamiast po cichu policzyć godzinę dwa razy.

Podłącz Claude Code

Komenda poniżej jest tą samą, którą pokazuje strona MCP. Rejestruje serwer dla Twojego użytkownika, więc jest dostępny w każdym projekcie na maszynie, a druga komenda otwiera przeglądarkę, żeby zatwierdzić dostęp:

claude mcp add --transport http --scope user sandtime https://mcp.sandtime.io/mcp
claude mcp login sandtime

Wolisz klucz API, na przykład na maszynie CI albo bez przeglądarki? Utwórz go w Sandtime.io w Ustawieniach, potem Integracje, potem API, i przekaż w nagłówku:

claude mcp add --transport http --scope user sandtime https://mcp.sandtime.io/mcp --header "Authorization: Bearer YOUR_API_KEY"

Użyj --scope project zamiast --scope user, żeby zapisać serwer w .mcp.json repozytorium, tak by każdy współtwórca go dostał. Sprawdź przez claude mcp list: sandtime powinien być oznaczony jako połączony. Claude Desktop czyta inny plik konfiguracyjny; strona MCP podaje dla niego JSON.

Podłącz Cursora

Cursor czyta serwery MCP z mcp.json, globalnie w ~/.cursor/ albo per projekt w .cursor/. Zdalny serwer potrzebuje adresu URL oraz, dopóki Cursor nie dokończy logowania przez przeglądarkę, nagłówka z kluczem API:

{
  "mcpServers": {
    "sandtime": {
      "url": "https://mcp.sandtime.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Strona MCP ma przycisk Add to Cursor, który wypełnia to za Ciebie. Gdy serwer świeci na zielono w ustawieniach MCP Cursora, narzędzia są dostępne w trybie agenta.

Codex CLI, Gemini CLI i GitHub Copilot w VS Code działają według tego samego schematu: dodaj adres serwera, wyślij klucz w nagłówku Bearer, a narzędzia się pojawią. Strona MCP ma osobną sekcję dla każdego klienta.

Przykład krok po kroku: „zapisz 2 godziny na projekt X za wczoraj”

Oto co dobry asystent robi z tym zdaniem, narzędzie po narzędziu. Sens przejścia przez kroki jest taki, żeby pokazać, że nic nie jest zgadywane: każdy krok czyta, zanim zapisze.

Gdyby krok 3 pokazał, że popołudnie jest już pełne, krok 4 by się nie wydarzył. Asystent zgłosiłby kolizję i zapytał, gdzie mają trafić te dwie godziny, dokładnie tak, jak zrobiłby to kolega przed edycją Twojego arkusza.

Warianty, które działają tak samo:

• „Wypełnij zeszły tydzień po 8 godzin dziennie na projekt platformy, pomiń piątek, było święto” wywołuje get_calendar, a potem fill_activities.
• „Co zapisałem w tym tygodniu, według projektów?” wywołuje get_time_summary.
• „Zatrzymaj mój timer” wywołuje stop_activity na wpisie bez godziny zakończenia.
• „Czy tydzień 35 jest zablokowany?” wywołuje get_timesheet_status, a „poproś o odblokowanie, muszę poprawić wtorek” wywołuje request_timesheet_unlock, które administrator widzi w aplikacji.

Czego serwer nie zrobi

Nie będzie Cię podglądał. Nie ma żadnego przechwytywania commitów, okien, klawiatury ani ekranu, w żadnym planie, i nic takiego nie jest planowane. Asystent wie tylko to, co powiesz mu w sesji, i zapisuje tylko to, o co poprosiłeś. To świadomy wybór: godzina, którą zadeklarowałeś, to godzina, za którą ręczysz, gdy arkusz zostanie zatwierdzony, a zespół, który ufa swoim zapisom, nie potrzebuje warstwy nadzoru, żeby je wytworzyć.

Trzyma się też Twoich uprawnień. Użytkownik rejestruje i odczytuje własny czas; Administrator może blokować tygodnie i rozpatrywać prośby o odblokowanie. Serwer MCP nie dodaje żadnej furtki omijającej role w aplikacji.

Podsumowanie

Rejestracja czasu zawodzi, gdy każe ludziom przerwać pracę, żeby zapisać pracę. Umieszczenie jej w asystencie, który już jest w sesji, usuwa tę wycieczkę, a zrobienie tego przez otwarty protokół oznacza, że ten sam serwer zadziała w edytorze, którego zespół użyje za rok.

Otwórz stronę serwera MCP, żeby zobaczyć konfigurację klient po kliencie, albo załóż darmowe konto, dodaj serwer powyższą komendą i zapisz pierwszy wpis z następnej sesji kodowania. Strona dla programistów obejmuje resztę dnia: tickety, wpisy wsteczne i raporty, o które poprosi Twój lead.