Dokumentacja API

Połącz serwer MCP RedReplier

RedReplier udostępnia hostowany serwer MCP, który korzysta z tego samego publicznego API REST. Użyj go, gdy klient AI ma bezpośrednio zarządzać stronami, słowami kluczowymi, wzmiankami, obszarami roboczymi i ustawieniami alertów.

URL MCP: https://mcp.redreplier.com/mcp

Uwierzytelnianie

Wskaż ten URL w kliencie MCP i zaloguj się, gdy otworzy się przeglądarka. Serwer odpowiada na nieuwierzytelnione żądania kodem 401 z nagłówkiem WWW-Authenticate, a klienty obsługujące OAuth (Claude Code, Claude Desktop, ChatGPT, Cursor) same otwierają logowanie do RedReplier. Nie trzeba wklejać klucza API.

Wolisz klucz? Agenty działające bez interfejsu i klienty bez OAuth mogą zamiast tego wysłać token API RedReplier w nagłówku Authorization. Serwer ustala konto na podstawie tego tokena.

Konfiguracja klienta

Jedno polecenie dla Claude Code:

claude mcp add --transport http redreplier https://mcp.redreplier.com/mcp

Pełna konfiguracja dla dowolnego klienta MCP:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp"
    }
  }
}

Wariant z kluczem API, dla agentów bez interfejsu i klientów bez OAuth:

{
  "mcpServers": {
    "redreplier": {
      "type": "http",
      "url": "https://mcp.redreplier.com/mcp",
      "headers": {
        "Authorization": "Bearer redreplier_your_key"
      }
    }
  }
}

Narzędzia

NarzędzieArgumentyZwraca
list_workspacesBrak argumentów{ workspaces: Workspace[] }
list_websitesBrak argumentów{ websites: Website[] }
get_websitewebsiteIdWebsite
create_websiteurl, opcjonalnie name, keywords, descriptionWebsite
update_websitewebsiteId, opcjonalnie name, descriptionWebsite
delete_websitewebsiteId{ deleted: true }
analyze_websiteurl{ description: string }
add_keywordswebsiteId, keywordsWebsite
edit_keywordkeywordId, valueKeyword
disable_keywordkeywordIdKeyword
enable_keywordkeywordIdKeyword
delete_keywordkeywordId{ deleted: true }
keyword_change_usageBrak argumentówwykorzystanie edycji słów
list_mentionsopcjonalnie websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, sort, from, to, limit, offsetMention[] z paginacją
count_mentionsopcjonalnie websiteId, statuses, scoreBuckets, includeLowRelevance, minScore, keywords, sources, from, to{ total: number }
update_mention_statusmentionId, statusMention
explain_mentionmentionIdMention | null
get_alert_settingsBrak argumentówustawienia alertów
update_alert_settingsenabled, opcjonalnie cadenceMinutesustawienia alertów

Uwagi

Logowanie OAuth może dawać dostęp do kilku obszarów roboczych. Wywołaj list_workspaces, aby je wyświetlić, a następnie przekaż id w opcjonalnym argumencie workspaceId, który przyjmuje każde inne narzędzie. Bez workspaceId narzędzia działają w domyślnym obszarze roboczym.

Zacznij od list_websites, aby klient poznał dostępne wartości websiteId i keywordId. Słowa kluczowe ponad limit planu pozostają w stanie PENDING, dopóki nie zwolni się miejsce. Wyłączenie lub usunięcie aktywnego słowa kluczowego albo usunięcie strony zwalnia miejsce, które zajmuje najstarsze oczekujące słowo kluczowe, jakie się mieści. Plan może zmienić tylko użytkownik, w aplikacji RedReplier. delete_keyword działa na słowie kluczowym w dowolnym statusie i usuwa też jego wzmianki, więc najpierw potwierdź to z użytkownikiem.

Rozwiązywanie problemów

  • Kod 401 przy żądaniu bez tokena to wyzwanie OAuth i jest czymś oczekiwanym. Klient powinien otworzyć okno logowania. Kod 401 z tokenem oznacza, że token Bearer jest niepoprawny, wygasł, został unieważniony lub nie zaczyna się od redreplier_.
  • Kod 403 z code: workspace_access_denied oznacza, że to logowanie nie ma dostępu do podanego workspaceId; wybierz identyfikator z list_workspaces. Kod 403 z code: subscription_required oznacza, że plan obszaru roboczego nie obejmuje dostępu do API. Kod 403 z code: permission_denied oznacza, że twoja rola w tym obszarze roboczym nie ma uprawnienia redreplier.write, które mają Administrator i Edytor; poproś administratora obszaru roboczego o rolę z tym uprawnieniem.
  • Błędy 404 zwykle oznaczają, że identyfikator należy do innej grupy kont albo został usunięty.
  • Słowo kluczowe, które pozostaje w stanie PENDING, nie mieści się w planie. Poproś użytkownika o zmianę planu w aplikacji RedReplier albo wyłącz lub usuń inne słowo kluczowe.