Dla agentów AI — serwer MCP rafsoft.net

Model Context Protocol (MCP) to otwarty standard komunikacji między agentami AI a zewnętrznymi źródłami danych, rozwijany przez Anthropic i wspierany m.in. przez Claude, ChatGPT i Perplexity. Zamiast scrapować strony WWW, agent AI może zadać precyzyjne pytanie przez ustandaryzowane API — i dostać ustrukturyzowaną odpowiedź. rafsoft.net udostępnia publiczny serwer MCP, dzięki któremu asystenci AI mają bezpośredni dostęp do bazy wiedzy, cennika i FAQ programu Faktura VAT 2026 oraz Mobilnej Faktury.

Endpoint serwera MCP

Parametr	Wartość
Adres	https://www.rafsoft.net/api/mcp/
Transport	Streamable HTTP (metoda POST)
Wersja protokołu	2024-11-05
Uwierzytelnianie	brak — serwer jest publiczny
Limit zapytań	60 zapytań na minutę na adres IP
Discovery	https://www.rafsoft.net/.well-known/mcp.json

Dostępne narzędzia

Narzędzie	Opis	Parametry
search_knowledge_base	Pełnotekstowe wyszukiwanie w bazie wiedzy (FAQ, dokumentacja, blog, cennik — ok. 590 fragmentów)	query (wymagany), topK (1–20, domyślnie 5)
get_product_info	Dane produktu: cennik, wersje programu, linki do pobrania z sumami SHA256, linki zakupu	section: all / product / pricing / downloads / mobilna
compare_editions	Porównanie wersji START / STANDARD / PRO: ceny netto i pełna macierz dostępności funkcji	editions (lista), onlyDifferences (bool)
get_faq	Pytania i odpowiedzi — FAQ programu oraz FAQ KSeF 2.0	source: all / program / ksef; section (filtr nazwy sekcji)
get_ksef_info	Informacje o integracji z KSeF 2.0: instrukcja, typy faktur, KSeF Client, walidator FA(3)	topic: all / integracja / faq / tabela-faktur / ksef-client / walidator

Jak podłączyć agenta AI

Claude Code (terminal)

claude mcp add --transport http rafsoft https://www.rafsoft.net/api/mcp/

Po dodaniu zapytaj np.: „porównaj wersje programu Faktura VAT" — Claude sam wywoła narzędzie compare_editions.

Claude.ai / Claude Desktop

W ustawieniach konta wybierz Settings → Connectors → Add custom connector i podaj adres https://www.rafsoft.net/api/mcp/. Serwer nie wymaga logowania ani klucza API.

Inne klienty MCP

Każdy klient obsługujący transport Streamable HTTP (np. ChatGPT z konektorami, Cursor, Windsurf, VS Code Copilot) podłączysz analogicznie — wystarczy adres endpointu. Konfigurację serwera można też sprawdzić wizualnie narzędziem MCP Inspector:

npx @modelcontextprotocol/inspector https://www.rafsoft.net/api/mcp/

Przykład wywołania (curl)

Lista narzędzi:

curl -s -X POST https://www.rafsoft.net/api/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Wyszukiwanie w bazie wiedzy:

curl -s -X POST https://www.rafsoft.net/api/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_knowledge_base","arguments":{"query":"ksef faktura vat","topK":3}}}'

Metadane dla crawlerów AI

Oprócz serwera MCP udostępniamy pliki w standardzie llms.txt:

• llms.txt — skrócone metadane o firmie i produktach,
• llms-full.txt — pełna treść z kompletem pytań i odpowiedzi FAQ.

Roboty AI (GPTBot, ClaudeBot, PerplexityBot i inne) mają jawnie dozwolone indeksowanie w robots.txt.

Zasady korzystania

• Serwer jest bezpłatny i publiczny — przeznaczony do odpytywania informacji o produktach RAFSOFT.NET.
• Obowiązuje limit 60 zapytań na minutę na adres IP; po przekroczeniu serwer zwraca HTTP 429 z nagłówkiem Retry-After.
• Dane zwracane przez narzędzia (cennik, FAQ, baza wiedzy) są aktualizowane automatycznie przy każdej zmianie treści serwisu.
• Pytania i sugestie: formularz kontaktowy lub biuro@rafsoft.net.