Przejdź do treści

Połącz klienta MCP

Korzystaj z HardlySimple w ulubionym agencie — ChatGPT, Claude, Cursor, Codex lub dowolnym kliencie obsługującym Model Context Protocol. Wskaż mu adres:

https://i8n.hardlysimple.com/mcp

Jeden endpoint, obie generacje protokołu: rewizja MCP 2026-07-28 jest obsługiwana natywnie (zapytaj server/discover), a klienci z 2025 roku nadal działają bez zmian przez te same narzędzia.

Opcja A — OAuth (zalecana)

W klientach obsługujących zdalne serwery MCP z OAuth wystarczy wpisać powyższy adres URL. Klient sam znajdzie nasz serwer autoryzacji, otworzy przeglądarkę do logowania i pokaże ekran zgody, na którym wybierzesz, do czego agent ma dostęp. Żadnych tokenów do kopiowania. Tokeny dostępu są krótkotrwałe i odświeżają się automatycznie, a każdą aplikację możesz w dowolnej chwili odłączyć w ustawieniach MCP.

Zaczynamy od zakresów tylko do odczytu — przyznaj dostęp do zapisu lub administracyjny tylko wtedy, gdy agent ma zmieniać Twoje dane.

Opcja B — Osobisty token dostępu (dla programistów i zaawansowanych)

Utwórz token z zakresami w ustawieniach MCP i wysyłaj go w nagłówku Bearer. Najlepsze do lokalnego programowania i agentów CLI. Token jest wyświetlany tylko raz — przechowuj go jak hasło.

Klienci, którzy przyjmują zdalny URL + nagłówki:

{
  "mcpServers": {
    "hardlysimple": {
      "url": "https://i8n.hardlysimple.com/mcp",
      "headers": {
        "Authorization": "Bearer ${HARDLYSIMPLE_PAT}"
      }
    }
  }
}

Klienci, którzy uruchamiają tylko lokalny most (stdio) — użyj mcp-remote:

{
  "mcpServers": {
    "hardlysimple": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://i8n.hardlysimple.com/mcp"
      ]
    }
  }
}

Z mcp-remote możesz przekazać token przez --header Authorization:"Bearer $HARDLYSIMPLE_PAT" albo pozwolić mu przeprowadzić logowanie OAuth w przeglądarce (pomiń nagłówek). Nigdy nie wklejaj tokenu do klienta, któremu nie ufasz.

Wskazówki dla klientów

  • ChatGPT — włącz Developer Mode / własne konektory, dodaj powyższy URL serwera MCP i dokończ zgodę OAuth. Zacznij od zakresów tylko do odczytu.
  • Claude / Cursor — jeśli klient obsługuje zdalne serwery MCP, dodaj URL i autoryzuj przez OAuth. Jeśli obsługuje tylko lokalną konfigurację (stdio), użyj opisanego wyżej mostu mcp-remote.
  • Codex / agenci CLI — użyj nagłówka Bearer z PAT albo mostu mcp-remote.

Zakresy

Zakresy ograniczają, co może zrobić połączenie; nigdy nie dają więcej, niż ma już Twoje konto.

  • Odczyt przestrzeni roboczej — Wyświetlanie Twoich zespołów, zadań, szkiców, decków (prezentacji i decków decyzyjnych), pakietów wiedzy, banków danych, systemów projektowych, danych strukturalnych, repozytoriów, artefaktów Claude i workflow agentów.
    hardlysimple:teams:readhardlysimple:tasks:readhardlysimple:sketches:readhardlysimple:knowledge-bundles:readhardlysimple:databanks:readhardlysimple:design-systems:readhardlysimple:structured-data:readhardlysimple:repositories:readhardlysimple:claude-artifacts:readhardlysimple:presentations:readhardlysimple:halfabs:readhardlysimple:decks:readhardlysimple:workflows:read
  • Edycja przestrzeni roboczej — Tworzenie i aktualizowanie Twoich zadań, szkiców, decków (prezentacji i decków decyzyjnych), pakietów wiedzy, banków danych, systemów projektowych zespołu, danych strukturalnych, repozytoriów, zapisanych artefaktów Claude i szkiców workflow agentów.
    hardlysimple:tasks:writehardlysimple:sketches:writehardlysimple:knowledge-bundles:writehardlysimple:databanks:writehardlysimple:design-systems:writehardlysimple:structured-data:writehardlysimple:repositories:writehardlysimple:claude-artifacts:writehardlysimple:presentations:writehardlysimple:halfabs:writehardlysimple:decks:writehardlysimple:workflows:write
  • Przesyłanie plików — Przesyłanie obrazów i plików do Twoich banków danych i na karty zadań.
    hardlysimple:databanks:uploadhardlysimple:tasks:upload
  • Odczyt profilu — Wyświetlanie Twojego imienia, adresu e-mail i danych profilu.
    hardlysimple:profile:read
  • Zarządzanie przypisaniami zadań — Sprawdzanie, co jest do Ciebie przypisane, i przypisywanie osób do zadań.
    hardlysimple:tasks:assign:readhardlysimple:tasks:assign:write
  • Sesje companionów — Przedstawianie się (dostawca, model, effort) i śledzenie własnej pracy jako sesji.
    hardlysimple:companions:readhardlysimple:companions:write
  • Twój kalendarz — Wyświetlanie Twojego połączonego kalendarza — w tym powiązanych kont Google — oraz dodawanie i usuwanie wydarzeń w Twoich własnych kalendarzach.
    hardlysimple:calendar:readhardlysimple:calendar:write
  • Przygotowywanie płatności — Wycena planu i przygotowanie linku do płatności, którą zrealizujesz na stronie rozliczeń HardlySimple. Agent nigdy nie widzi danych karty i nie może zapłacić.
    hardlysimple:billing:readhardlysimple:billing:write
  • Administrowanie przestrzenią roboczą — Pełny dostęp administracyjny (działa tylko, jeśli Twoje konto ma uprawnienia administratora).
    hardlysimple:admin