Wersja zapoznawcza dla deweloperów

Serwer MCP Sandtime.io

Model Context Protocol (MCP) pozwala klientom AI, takim jak Claude Code i Codex, komunikować się bezpośrednio z Sandtime.io. Połącz raz i twórz, przeglądaj oraz raportuj wpisy czasu z narzędzi, których już używasz.

Czym jest MCP?

Model Context Protocol to otwarty standard łączenia asystentów AI z zewnętrznymi narzędziami i danymi. Serwer MCP Sandtime.io udostępnia Twoją przestrzeń śledzenia czasu - aktywności, projekty, raporty, grafiki i więcej - jako zestaw narzędzi, które asystent może wywoływać w Twoim imieniu.

Akcje odczytu zwracają czyste, zmaterializowane dane ze sformatowanymi czasami trwania i czasami lokalnymi. Akcje destrukcyjne, takie jak usunięcie projektu lub członka zespołu, celowo przekazują decyzję człowiekowi, zwracając bezpośredni link do właściwej strony w aplikacji.

Dopiero zaczynasz rejestrować czas z poziomu edytora? Zobacz, jak deweloperzy korzystają z Sandtime.io na co dzień.

O co możesz zapytać

Rozmawiaj ze swoim asystentem zwykłym językiem. Sam ustali właściwego użytkownika, projekt i daty, a następnie wywoła za Ciebie odpowiednie narzędzia.

Zarejestruj 8 godzin w projekcie Acme na wczoraj.
Uzupełnij zeszły tydzień moimi zwykłymi godzinami i pomiń święto.
Co zarejestrowałem w tym tygodniu, w podziale na projekty?
Zatrzymaj mój działający stoper.
Zbuduj raport godzin rozliczalnych według klienta za ostatni miesiąc.
Które tygodnie są nadal zablokowane w moim grafiku?

Połącz z Claude

Dodaj serwer Sandtime.io do konfiguracji swojego klienta MCP. W Claude Code znajduje się ona w pliku .mcp.json:

{
  "mcpServers": {
    "sandtime": {
      "type": "http",
      "url": "https://mcp.sandtime.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ACCESS_TOKEN",
        "X-Sandtime-Organization": "your-organization"
      }
    }
  }
}
Uwierzytelnianie jest w trakcie prac. Obecnie uwierzytelniasz się, kopiując token dostępu z pliku cookie sesji Sandtime.io i wklejając go jako token Bearer, wraz z identyfikatorem (slug) organizacji w nagłówku X-Sandtime-Organization. To rozwiązanie tymczasowe - wkrótce udostępnimy właściwy proces logowania i wydawania tokenów, dzięki czemu nie będziesz musiał ruszać plików cookie.

Gdzie to działa

Jeden serwer HTTP dla każdego narzędzia AI, którego używasz. Połącz raz i pracuj stamtąd, gdzie już jesteś.

Claude Code

Dodaj serwer do swojego pliku .mcp.json i rejestruj czas z poziomu terminala, w którym wdrażasz kod.

Claude Desktop

Połącz serwer i poproś aplikację desktopową o śledzenie i raportowanie Twojego czasu.

Codex

Podłącz serwer do Codex i zamień sesje kodowania w czyste zapisy czasu.

Dowolny klient MCP

Połączyć się może każdy klient obsługujący Model Context Protocol oraz serwery HTTP z własnymi nagłówkami.

Dostępne narzędzia

Serwer udostępnia ponad 30 narzędzi obejmujących całą Twoją przestrzeń roboczą. Asystenci łączą je w sekwencje - na przykład ustalając bieżącego użytkownika, sprawdzając kalendarz, a następnie uzupełniając puste dni.

Aktywności

  • list_activitiesWyświetl listę wpisów czasu, filtrowaną według użytkownika, projektu lub całego tygodnia. Zwraca sformatowane czasy trwania i czasy lokalne.
  • get_activityPobierz pełne szczegóły pojedynczego wpisu czasu na podstawie jego identyfikatora.
  • create_activityZarejestruj nowy wpis czasu w projekcie, z automatycznym wykrywaniem nakładania się z istniejącymi wpisami.
  • update_activityEdytuj nazwę, godziny, projekt lub status rozliczalności wpisu czasu albo zatrzymaj i wznów działający stoper.
  • delete_activityTrwale usuń wpis czasu. Wymaga bycia właścicielem lub uprawnień administratora.
  • stop_activityZatrzymaj działający stoper, ustawiając jego czas zakończenia na teraz.

Projekty

  • list_projectsWyświetl listę projektów w Twojej organizacji, opcjonalnie wraz z zarchiwizowanymi.
  • get_projectPobierz szczegółowe informacje o konkretnym projekcie.
  • create_projectUtwórz nowy projekt. Wymaga uprawnień administratora.
  • update_projectZmień nazwę projektu, zmień jego domyślny status rozliczalności, zarchiwizuj go lub edytuj jego notatki.
  • delete_projectZwraca bezpośredni link do ustawień projektu, gdzie człowiek potwierdza usunięcie.

Członkowie projektu

  • list_project_membersWyświetl listę członków przypisanych do konkretnego projektu.
  • add_project_memberZwraca bezpośredni link do sekcji członków projektu, gdzie człowiek dodaje członka.
  • remove_project_memberZwraca bezpośredni link do sekcji członków projektu, gdzie człowiek usuwa członka.

Użytkownicy

  • list_usersWyświetl listę użytkowników w Twojej organizacji.
  • get_userPobierz szczegółowe informacje o konkretnym użytkowniku.
  • get_current_userPobierz identyfikator wywołującego, strefę czasową oraz ustaloną przez serwer bieżącą datę i tydzień. Zwykle pierwsze wywołanie w przepływie pracy.
  • create_userZwraca bezpośredni link do strony zapraszania członków.
  • update_userZwraca bezpośredni link do strony profilu użytkownika.

Organizacja

  • get_organizationPobierz informacje o swojej organizacji, w tym jej ustawienia.
  • update_organizationZwraca bezpośredni link do strony ustawień organizacji.

Kalendarz

  • get_calendarPobierz obliczony po stronie serwera kalendarz z dniami roboczymi, oczekiwanymi godzinami, weekendami i świętami. Źródło prawdy przed rejestrowaniem czasu na przestrzeni dni.

Raporty

  • list_reportsWyświetl listę zapisanych raportów w Twojej organizacji.
  • get_reportPobierz szczegóły konkretnego raportu.
  • create_reportZbuduj zapisany raport z własnymi wymiarami, metrykami, okresami oraz filtrami projektów lub członków zespołu.

Arkusz czasu pracy

  • get_timesheet_statusSprawdź status blokady grafików dla wybranego tygodnia.
  • lock_timesheetZablokuj tygodniowy grafik dla użytkownika. Wymaga uprawnień administratora.
  • unlock_timesheetUsuń istniejącą blokadę grafiku. Wymaga uprawnień administratora.

Żądania

  • list_requestsWyświetl listę żądań do zatwierdzenia, takich jak odblokowania grafików i zmiany ról. Domyślnie pokazuje żądania oczekujące.
  • request_timesheet_unlockPoproś administratora o odblokowanie zablokowanego tygodnia, aby można było edytować grafik.
  • approve_unlock_requestZatwierdź oczekujące żądanie odblokowania, dając użytkownikowi krótki czas na edycję. Wymaga uprawnień administratora.
  • reject_unlock_requestOdrzuć oczekujące żądanie odblokowania. Użytkownik zostanie powiadomiony.

Podsumowanie i analityka

  • get_time_summaryPodsumuj zarejestrowany czas w danym okresie, pogrupowany według dnia, tygodnia, miesiąca, projektu lub użytkownika.

Wypróbuj funkcje AI za darmo

Serwer MCP i Sandbot są bezpłatne dla kwalifikujących się organizacji w okresie wczesnego dostępu. Opowiedz nam o swoim zespole, a my je włączymy.

Zobacz ofertę wczesnego dostępu