Przejdz do głównej tresci

Pozwól agentowi prowadzić Twoją listę zadań

Szukasz serwera MCP do zadań, który działa na prawdziwych plikach zamiast na hostowanej bazie danych? taskforge dostarcza jeden jako podpolecenie, taskforge mcp --stdio, dla Twojego sejfu Obsidian. Wskaż go Claude Desktop albo innemu klientowi MCP, a agent dodaje, wyszukuje, edytuje i kończy zadania za pomocą niewielkiego zestawu narzędzi. Działa na Twoim komputerze i edytuje te same pliki markdown, co aplikacja. Bez hostowanego serwera, bez klucza API.

Już wkrótce w TaskForge 3.0

CLI TaskForge i serwer MCP pojawią się wraz z wydaniem TaskForge 3.0. Ta strona opisuje, jak będą działać po premierze. Sama aplikacja TaskForge jest dostępna do pobrania już teraz.

MCP czy CLI?

Wybieraj narzędzia MCP, gdy Twój agent ma już połączenie MCP z TaskForge. Są typowane, zwracają ustrukturyzowane błędy, na podstawie których agent może się samodzielnie poprawić, i niczego nie wymagają w Twoim PATH. Sięgnij zamiast tego po CLI w kontekstach powłoki bez połączenia MCP: skrypty, cron, CI albo agent kodujący pracujący na lokalnej kopii repozytorium. Oba sterują tym samym silnikiem z identyczną semantyką, więc wybierz to, co jest już podpięte w Twoim środowisku. Ręczna edycja plików sejfu to ostateczność.

Instalacja

Zalecane: npx

Dodaj to do konfiguracji swojego klienta MCP. npx pobiera taskforge-md przy pierwszym uruchomieniu, więc nie trzeba nic instalować wcześniej.

Claude Desktop, jedno kliknięcie

Wolisz instalację z kreatorem? Pobierz pakiet taskforge (plik .mcpb) i otwórz go. Claude Desktop przeprowadzi Cię przez konfigurację i zapyta o folder Twojego sejfu.

Dostępne od premiery 
{
  "mcpServers": {
    "taskforge": {
      "command": "npx",
      "args": ["-y", "taskforge-md", "mcp", "--stdio"],
      "env": {
        "TASKFORGE_VAULT": "/path/to/your/vault"
      }
    }
  }
}

Zbudowano taskforge ze źródeł zamiast używać npx? Skieruj konfigurację bezpośrednio na plik binarny:

Dostępne od premiery 
"command": "taskforge",
"args": ["mcp", "--stdio"]

Tylko na komputery, bo tam żyją klienci MCP. taskforge jest dostępny jako jeden natywny plik binarny dla macOS, Windows i Linux, a serwer MCP jest jednym z jego podpoleceń.

Pełny zestaw narzędzi

22 narzędzia w sumie, obejmujące cały cykl życia zadania: tworzenie, odczyt, aktualizację, ukończenie, archiwizację i usuwanie, każde z wariantem grupowym; przenoszenie, zmianę rodzica oraz konwersję między wierszem inline a plikiem TaskNotes; sprawdzenie lint przed zapisaniem wiersza; wywołanie doctor do sprawdzenia stanu sejfu; a także zasoby schematu i list, dzięki którym agent pozna Twój format, zanim zacznie działać. Sześć poniżej to te, po które sięgniesz najczęściej. Każde wywołanie odczytuje sejf na nowo z dysku, więc agent zawsze działa na aktualnych plikach.

query_tasks Wyszukuj i filtruj zadania albo odczytaj zapisaną listę. Tylko do odczytu. tylko do odczytu
get_task Odczytaj jedno zadanie wraz z hashem jego treści. Tylko do odczytu. tylko do odczytu
add_task Utwórz zadanie w domyślnym miejscu docelowym sejfu, w Twoim formacie. zapisuje
update_task Zmień status, priorytet, termin, tytuł lub tagi zadania. zapisuje
complete_task Zakończ zadanie; zwraca kolejne wystąpienie, jeśli jest cykliczne. zapisuje, nieidempotentne
delete_task Usuń zadanie. Model musi odesłać dokładny, aktualny tytuł zadania, co chroni przed działaniem na nieaktualnym lub zmyślonym id. niszczące

Każde narzędzie ma adnotacje, dzięki czemu klient od razu widzi, które wywołania tylko odczytują, które zapisują, a które usuwają. Reszta zestawu obejmuje też bulk_add_tasks, bulk_update_tasks, bulk_complete_tasks, bulk_delete_tasks, get_tasks, archive_task, move_task, bulk_move_tasks, convert_task, bulk_convert_tasks, outdent_task, bulk_reparent_tasks, lint_task, doctor, list_task_lists i get_schema.

Trzy zasoby

Oprócz narzędzi serwer udostępnia kontekst tylko do odczytu, dzięki czemu agent poznaje zasady Twojego sejfu, zanim zacznie działać:

taskforge://schema Czytelny dla maszyn dialekt zadań: symbole statusów, format daty, pola niestandardowe, miejsca zapisu.
taskforge://agents-guide Przewodnik po konwencjach zadań Twojego sejfu, napisany prostym językiem.
taskforge://lists Twoje zapisane listy zadań i sposób dodawania zadania do każdej z nich.

Jeden wymóg: kontrakt sejfu

Serwer odczytuje pliki kontraktu, które TaskForge zapisuje w Twoim sejfie, taskforge/schema.json i taskforge/agents.md, aby poznać dokładny format Twoich zadań. Otwórz sejf w TaskForge 3.0 lub nowszym przynajmniej raz, przejdź do Settings, AI & Agents, i pozostaw włączoną opcję "Generate agent files". Jeśli sejf nigdy nie został otwarty w niedawnej wersji aplikacji, serwer korzysta z ogólnych wartości domyślnych i ostrzega klienta.

Jeśli nie może znaleźć Twojego sejfu

Serwer zawsze się uruchamia, nawet zanim wie, gdzie jest Twój sejf, więc Claude Desktop nigdy nie pokazuje niejasnego komunikatu "server failed to start". Gdy wywołanie narzędzia nie może rozwiązać sejfu, zwraca prosty błąd, który agent może przekazać dalej: ustaw zmienną środowiskową TASKFORGE_VAULT na ścieżkę do swojego sejfu albo zainstaluj pakiet ponownie i podaj folder sejfu, gdy zostaniesz o to poproszony.

Tylko lokalnie

taskforge mcp --stdio odczytuje i zapisuje pliki markdown w skonfigurowanym przez Ciebie sejfie i nic więcej. Bez konta, bez chmury. Twoja dotychczasowa synchronizacja, iCloud, Dropbox czy Obsidian Sync, przenosi zmiany między urządzeniami.

Wolisz terminal?

Jeśli wolisz obsługiwać zadania skryptami albo uruchamiać jednorazowe polecenia zamiast prowadzić je przez agenta, taskforge CLI obejmuje ten sam sejf, z tymi samymi zasadami.

Zainstaluj taskforge CLI →

Najczęściej zadawane pytania

Czym jest serwer MCP taskforge?

To lokalny serwer Model Context Protocol wbudowany w plik binarny taskforge. Uruchom go poleceniem taskforge mcp --stdio, a klient MCP taki jak Claude Desktop będzie mógł dodawać, wyszukiwać, edytować, przenosić, kończyć i usuwać zadania w Twoim sejfie Obsidian za pomocą 22 typowanych narzędzi, pojedynczo lub grupowo. To lista zadań, na której Twój agent może działać, a nie tylko ją czytać.

Z jakimi klientami MCP współpracuje?

Z każdym klientem, który mówi w MCP przez stdio. Claude Desktop jest najczęstszy, a Claude Code, Cursor i VS Code (dla GitHub Copilot) przyjmują tę samą konfigurację. Każdy otrzymuje te same 22 narzędzia i te same trzy zasoby.

Czy to hostowany albo zdalny serwer MCP?

Nie. Działa na Twoim komputerze przez stdin i stdout i dotyka wyłącznie folderu sejfu, który mu wskażesz. Nie ma adresu URL do hostowania, klucza API ani konta TaskForge. O to właśnie chodzi: Twoja lista zadań zostaje na Twoim dysku.

Czy muszę coś instalować?

Nie z wyprzedzeniem. Wskaż w konfiguracji klienta npx -y taskforge-md mcp --stdio, a npx pobierze pakiet przy pierwszym uruchomieniu. Użytkownicy Claude Desktop mogą zamiast tego otworzyć pakiet .mcpb, aby skorzystać z instalacji z kreatorem.

Klient mówi, że serwer nie może znaleźć mojego sejfu. Co teraz?

Serwer zawsze się uruchamia, więc klient nigdy nie pokazuje niejasnego komunikatu "failed to start". Gdy wywołanie narzędzia nie może rozwiązać sejfu, zwraca prosty komunikat: ustaw zmienną środowiskową TASKFORGE_VAULT na ścieżkę do swojego sejfu albo zainstaluj pakiet ponownie i podaj folder sejfu, gdy zostaniesz o to poproszony.

Czy potrzebuje plików kontraktu sejfu?

Tak, aby dopasować się do Twojego formatu. Odczytuje taskforge/schema.json i taskforge/agents.md, generowane, gdy otworzysz sejf w TaskForge 3.0 lub nowszym z włączoną opcją "Generate agent files". Bez nich nadal działa, ale korzysta z ogólnych wartości domyślnych i ostrzega klienta, że zgaduje.

Agent działa na liście. Aplikacja ją przechowuje.

Serwer MCP zapisuje do Twojego sejfu; TaskForge zamienia te pliki w listy, widżety i przypomnienia na wszystkich Twoich urządzeniach. Darmowy do pobrania na iPhone'a, iPada, Maca i Androida.

Apple Pobierz za darmo - iOS i Mac Android Pobierz za darmo - Android