Przejdź do instrukcji
zoraforms.
Otwórz panel
Spis dokumentacji

MCP: Codex i Claude

Połącz Codex lub Claude z ZoraForms. Zleć konfigurację witryn i formularzy, wybierając uprawnienia do swoich danych.

Utwórz token dostępu

  1. Otwórz Ustawienia → MCP. Nadaj tokenowi nazwę i wybierz ważność: 1, 7, 30 lub 90 dni.
  2. Pozostaw odczyt konfiguracji. Zapis konfiguracji pozwala klientowi tworzyć i zmieniać witryny, formularze, CAPTCHA oraz webhooki.
  3. Odczyt zgłoszeń włącz tylko wtedy, gdy klient ma pracować z ich danymi. Domyślnie jest wyłączony i wymaga osobnej zgody.
  4. Utwórz token i skopiuj go teraz. Pełny sekret jest dostępny tylko raz. Możesz mieć maksymalnie 5 aktywnych tokenów i cofnąć każdy z nich w panelu.

Podłącz do Codex

W panelu znajdziesz gotową komendę dla adresu Twojej instalacji. W przykładzie zastąp forms.example.com swoją domeną. Token musi być dostępny w środowisku procesu Codex.

Dodanie serweraCLI
codex mcp add zoraforms --url https://forms.example.com/mcp --bearer-token-env-var ZORAFORMS_MCP_TOKEN
Alternatywnie: konfiguracja klientaTOML
[mcp_servers.zoraforms]
url = "https://forms.example.com/mcp"
bearer_token_env_var = "ZORAFORMS_MCP_TOKEN"

Uruchom ponownie klienta po zmianie środowiska i rozpocznij nowy czat. Eksport zmiennej w terminalu nie zmienia środowiska już uruchomionej aplikacji desktopowej. ZoraForms nie edytuje automatycznie konfiguracji Twojego klienta.

Podłącz do Claude Code

Ustaw ZORAFORMS_MCP_TOKEN w środowisku Claude Code. W katalogu projektu użyj komendy poniżej; lokalny wpis zawiera odwołanie do zmiennej, bez pełnego tokenu. Zastąp domenę adresem swojej instalacji.

Dodanie serwera do Claude CodeCLI
claude mcp add-json --scope local zoraforms '{"type":"http","url":"https://forms.example.com/mcp","headers":{"Authorization":"Bearer ${ZORAFORMS_MCP_TOKEN}"}}'
Alternatywnie: wpis do .mcp.jsonJSON
{
  "mcpServers": {
    "zoraforms": {
      "type": "http",
      "url": "https://forms.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ZORAFORMS_MCP_TOKEN}"
      }
    }
  }
}

Scal wpis z istniejącymi mcpServers. Uruchom claude mcp list, aby sprawdzić połączenie, a /mcp w nowej sesji, aby zobaczyć narzędzia. Przy pliku projektowym klient może poprosić o zatwierdzenie serwera. Lokalny adres działa, jeśli Claude Code ma do niego dostęp.

Oficjalna instrukcja Claude Code MCP

Claude w przeglądarce i aplikacji

  1. Udostępnij instalację ZoraForms pod publicznym HTTPS. Konektor chmurowy Claude nie połączy się z localhost.
  2. W ustawieniach Claude otwórz Connectors i dodaj własny konektor z adresem https://forms.example.com/mcp.
  3. Wybierz Authentication: No sign-in. W Request headers dodaj wymagany nagłówek Authorization i wartość Bearer TWÓJ_TOKEN, podstawiając własny token z panelu. To ustawienie klienta — endpoint nadal wymaga uwierzytelnienia.
  4. Włącz konektor w rozmowie i zleć konfigurację. Po wygaśnięciu lub cofnięciu tokenu utwórz nowy; zmiana sposobu uwierzytelnienia konektora może wymagać jego ponownego dodania.
Oficjalna instrukcja konektorów Claude

Co możesz zlecić

Przykładowe poleceniePrompt
Sprawdź moje limity. Utwórz witrynę example.com i formularz kontaktowy. Ustaw origin https://example.com i użyj mojego credentiala Turnstile Managed. Wygeneruj HTML z UTM. Podłącz mój webhook https://hooks.example.com/forms.

MCP korzysta z własnych zasobów konta i aktualnych limitów. Udostępnia także odczyt użycia, ustawienia formularza, kod integracji oraz test webhooka. Odczyt zgłoszeń jest widoczny tylko z osobnym uprawnieniem.

MCP nie obsługuje administratorów, płatności, profilu ani tworzenia kolejnych tokenów. Zatwierdzanie zmian zależy od polityki klienta; potwierdzaj usuwanie i nowych odbiorców danych. Treść zgłoszeń jest niezaufanymi danymi, a nie instrukcjami dla modelu.

MCP: Codex i Claude · ZoraForms Docs