Dokumentacja

Agenci AI (MCP)

Połącz serwer MCP

Połącz Claude, Claude Code, ChatGPT, Cursor, VS Code lub Codex ze swoją przestrzenią roboczą AmICited przez MCP. Jeden adres URL, logowanie OAuth i klucz API jako rozwiązanie awaryjne.

AmICited prowadzi stale działający serwer MCP (Model Context Protocol). Gdy Twój klient AI jest połączony, może czytać Twoje dane o widoczności, uruchamiać raporty i, z dostępem do zapisu, dodawać prompty, generować artykuły lub zapisywać adnotacje, wszystko ze zwykłej rozmowy. Każda funkcja pulpitu jest też dostępna jako narzędzie MCP, więc nie ma niczego, co możesz zrobić w aplikacji, a czego agent nie mógłby zrobić.

Zanim zaczniesz#

  • Plan, który zawiera MCP. MCP jest dostępne w 7-dniowym okresie próbnym oraz w planach Pro, Premium i Enterprise. Przestrzenie robocze Starter widzą adres URL serwera, ale połączenia są odrzucane, dopóki plan nie zostanie podniesiony. Zobacz plany i limity.
  • Uprawnienia Editor lub wyższe w przestrzeni roboczej. Strona MCP mówi członkom bez nich, aby poprosili właściciela lub administratora przestrzeni roboczej.
  • Dodatnie saldo kredytów. Odczyty przez MCP są darmowe, ale punkt końcowy sprawdza, czy przestrzeń robocza ma kredyty, zanim odpowie. Zobacz kredyty.

Adres URL serwera#

Jest jeden adres URL dla wszystkich:

text
https://api.flowhunt.io/mcp/amicited

Przestrzeni roboczej nie ma w adresie URL. Pochodzi z Twojego poświadczenia: przy OAuth wybierasz przestrzeń roboczą na ekranie zgody, a klucz API już należy do jednej przestrzeni roboczej. Adres URL możesz też skopiować ze strony MCP w aplikacji, która pokazuje go z przyciskiem Copy URL i tymi samymi instrukcjami dla poszczególnych klientów co poniżej. Transport to streamable HTTP.

Połącz swojego klienta#

Wybierz swojego klienta. Każda karta zaczyna się od zalecanego logowania OAuth i kończy alternatywą z kluczem API.

Claude (web i Desktop)

Konektory dodane na claude.ai są dostępne także w aplikacji Claude Desktop.

  1. Otwórz ustawienia konektorów Claude.
  2. Kliknij +, a potem Add custom connector.
  3. Wklej https://api.flowhunt.io/mcp/amicited i kliknij Add.
  4. Kliknij Connect przy nowym konektorze i zatwierdź dostęp w oknie przeglądarki, które się otworzy. Wybierz swoją przestrzeń roboczą na ekranie zgody.

W czacie otwórz menu narzędzi i upewnij się, że konektor AmICited jest włączony.

Alternatywa z kluczem API (plik konfiguracyjny Claude Desktop). Dodaj to w mcpServers w ~/Library/Application Support/Claude/claude_desktop_config.json na macOS, a następnie uruchom ponownie Claude Desktop:

claude_desktop_config.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

Claude Code

Zarejestruj serwer raz z terminala:

bash
claude mcp add --transport http amicited https://api.flowhunt.io/mcp/amicited

Następnie uruchom /mcp w Claude Code, wybierz Authenticate i zatwierdź dostęp w oknie przeglądarki, które się otworzy.

Alternatywa z kluczem API. Dodaj serwer w kluczu najwyższego poziomu mcpServers w ~/.claude.json i uruchom ponownie Claude Code:

~/.claude.json
{
  "mcpServers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited",
      "headers": {
        "Authorization": "Bearer <your-workspace-api-key>"
      }
    }
  }
}

ChatGPT

Niestandardowe konektory MCP wymagają Developer mode, dostępnego w płatnych planach ChatGPT (Plus, Pro, Team, Enterprise). W przestrzeniach roboczych Business, Enterprise i Edu administrator może musieć go dla Ciebie włączyć.

  1. Włącz Developer mode zgodnie z dokumentacją konektorów OpenAI.
  2. W ChatGPT otwórz Settings, a potem Apps & Connectors.
  3. Dodaj niestandardowy konektor i wklej https://api.flowhunt.io/mcp/amicited.
  4. Zatwierdź dostęp w oknie przeglądarki, które się otworzy.

Alternatywa z kluczem API. W kroku 4 wybierz zamiast tego uwierzytelnianie kluczem API i wklej klucz API swojej przestrzeni roboczej. Zapisz konektor, a następnie włącz go w nowym czacie.

Cursor

Na stronie MCP w aplikacji wybierz Cursor i kliknij Add to Cursor. Cursor instaluje serwer i przeprowadza logowanie za Ciebie.

Jeśli przycisk nie otwiera Cursora, dodaj serwer ręcznie w ustawieniach Cursora w sekcji MCP albo edytuj ~/.cursor/mcp.json (lub .cursor/mcp.json dla projektu):

~/.cursor/mcp.json
{
  "mcpServers": {
    "amicited": {
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Cursor otwiera przeglądarkę do zalogowania przy pierwszym połączeniu. Ustaw czat w tryb Agent, aby używać narzędzi.

Alternatywa z kluczem API. Dodaj nagłówek do tego samego wpisu:

json
"headers": { "Authorization": "Bearer <your-workspace-api-key>" }

VS Code

VS Code korzysta z serwera przez GitHub Copilot w trybie Agent, więc Copilot musi być włączony.

Na stronie MCP w aplikacji wybierz VS Code i kliknij Add to VS Code. VS Code instaluje serwer i przeprowadza logowanie za Ciebie.

Aby dodać ręcznie, otwórz paletę poleceń, uruchom MCP: Open User Configuration i dodaj serwer w servers:

mcp.json
{
  "servers": {
    "amicited": {
      "type": "http",
      "url": "https://api.flowhunt.io/mcp/amicited"
    }
  }
}

Alternatywa z kluczem API. Dodaj "headers": { "Authorization": "Bearer <your-workspace-api-key>" } do wpisu. Możesz też uruchomić MCP: Add Server…, wybrać HTTP (HTTP or Server-Sent Events), wkleić adres URL i dodać nagłówek Authorization, gdy zostaniesz o to poproszony.

Codex

Codex łączy się jako standardowy zdalny klient MCP. Dodaj serwer, a następnie zaloguj się:

bash
codex mcp add amicited --url https://api.flowhunt.io/mcp/amicited
codex mcp login amicited

Albo edytuj bezpośrednio ~/.codex/config.toml:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
oauth_resource = "https://api.flowhunt.io/mcp/amicited"

Alternatywa z kluczem API. Umieść klucz w zmiennej środowiskowej i wskaż ją Codexowi:

~/.codex/config.toml
[mcp_servers.amicited]
url = "https://api.flowhunt.io/mcp/amicited"
bearer_token_env_var = "AMICITED_API_KEY"

Codex uruchomiony z rygorystycznymi ustawieniami zatwierdzania nadal dotrze do każdego narzędzia tylko do odczytu przez read_tool. Zobacz zestawy narzędzi i narzędzia.

OAuth czy klucz API#

OAuth 2.1 (zalecane)Klucz API przestrzeni roboczej (awaryjnie)
KonfiguracjaWklej adres URL, zatwierdź w przeglądarceWklej adres URL plus nagłówek Authorization: Bearer
Przestrzeń roboczaWybierana na ekranie zgodyUstalona przez klucz
Uprawnieniaamicited:read do połączenia i odczytu; do zapisów potrzebne jest też amicited:writePełny dostęp do przestrzeni roboczej
CofanieConnected clients → Revoke na stronie MCPUsuń lub wygaś klucz

OAuth to lepsza wartość domyślna: nie ma sekretu do wklejania do pliku konfiguracyjnego, każdy klient pojawia się z nazwy na stronie MCP w Connected clients i możesz cofnąć jednego, nie ruszając pozostałych. Token OAuth tylko do odczytu może wypisywać i czytać wszystko, ale każde narzędzie, które tworzy, edytuje lub usuwa, odmówi komunikatem wskazującym zakres amicited:write. Ponawianie nie pomoże; połącz się ponownie z dostępem do zapisu.

Traktuj klucz API jak hasło

Każdy, kto ma klucz API przestrzeni roboczej, może uruchamiać każde narzędzie serwera na danych Twojej przestrzeni roboczej, w tym zapisy. Wybieraj OAuth, trzymaj klucze poza wspólnymi repozytoriami i używaj zmiennej środowiskowej tam, gdzie Twój klient ją obsługuje.

Sprawdź, czy działa#

Zapytaj agenta o coś małego: „List my AmICited domains.” Powinien wywołać list_domains i zwrócić Twoje domeny z nazwy. Potem spróbuj „Show my AI visibility for the last 30 days”, co używa prompt_analytics.

Jeśli połączenie zostanie odrzucone, komunikat zwykle mówi dlaczego:

  • Plan. „requires a Pro plan or above”: plan właściciela przestrzeni roboczej nie zawiera MCP.
  • Kredyty. Saldo przestrzeni roboczej wynosi zero lub jest ujemne. Doładuj i spróbuj ponownie.
  • Limit żądań. Wywołania narzędzi są ograniczone na przestrzeń roboczą na godzinę: 120 w okresie próbnym, 600 w Pro, 2000 w Premium, bez limitu w Enterprise. Komunikat podaje, kiedy okno się resetuje. Wypisywanie narzędzi i czytanie skilli się nie liczy.

Powiązane#