Skip to content

Podłączenie dokumentacji API do agenta AI

Jak dodać serwer MCP tej dokumentacji do Claude Code, Cursora lub innego agenta AI, żeby przy pisaniu integracji korzystał z aktualnych informacji.

Zaktualizowano

Agent z dostępem do serwera MCP dokumentacji samodzielnie wyszukuje i odczytuje właściwe strony, zamiast zgadywać nazwy endpointów. Serwer jest publiczny i nie wymaga logowania.

Wymagania

  • Narzędzie AI obsługujące zdalne serwery MCP przez HTTP (Streamable HTTP).

Kroki

  1. Dodanie serwera

    claude mcp add --transport http infakt-docs https://docs.niebieskiorzel.pl/mcp

    Wpis dodaje się do ~/.cursor/mcp.json (Windows: %USERPROFILE%\.cursor\mcp.json), a następnie uruchamia Cursor ponownie:

    {
      "mcpServers": {
        "infakt-docs": {
          "url": "https://docs.niebieskiorzel.pl/mcp"
        }
      }
    }

    Wpis dodaje się do pliku konfiguracji (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json), a następnie uruchamia aplikację ponownie:

    {
      "mcpServers": {
        "infakt-docs": {
          "url": "https://docs.niebieskiorzel.pl/mcp"
        }
      }
    }

    W ustawieniach narzędzia podaje się adres serwera https://docs.niebieskiorzel.pl/mcp i transport HTTP (Streamable HTTP). Logowanie nie jest wymagane.

  2. Pytanie o API

    Przykładowe pytanie do agenta: „Jak wysłać fakturę do KSeF przez API inFakt? Sprawdź w dokumentacji infakt-docs”.

Weryfikacja

Agent wywołuje narzędzia list_pages i get_page serwera infakt-docs, a w odpowiedzi opiera się na stronie Wysyłka faktury do KSeF i podaje endpoint POST /ksef2/documents/{uuid}/send.json.

Jeśli agent nie widzi narzędzi, należy sprawdzić adres serwera i uruchomić narzędzie ponownie. Prawidłowy adres można skopiować przyciskiem Kopiuj adres MCP u góry tej strony.

Następne kroki

Type to search…

↑↓ wybór↵ otwórzEsc zamyka