Jak przeszukac baze wiedzy MacLife przez API?

POST na https://chatbot.maclife.pl/api/v1/tools/baza z body {zapytanie: 'twoje pytanie'}

Czy API MacLife wymaga klucza?

Baza wiedzy i info_o_serwisie sa publiczne. Skladanie zgloszen wymaga X-API-Key.

Jaki jest adres serwera MCP MacLife?

https://chatbot.maclife.pl/mcp - Streamable HTTP POST. Dla Claude Desktop: npx -y mcp-remote https://chatbot.maclife.pl/mcp

Klienci

Sprawdzam serwer… · OpenAPI ↗

Podłącz Claude
do MacLife

Daj asystentowi AI dostęp do aktualnych cenników, procedur serwisowych i zgłoszeń napraw — w czasie rzeczywistym.

Wybierz aplikację

Claude Desktop

Windows & macOS

via npx mcp-remote · wymaga Node.js

Edytuj plik konfiguracyjny i zrestartuj aplikację. Narzędzia MacLife dostępne w każdej rozmowie.

claude_desktop_config.json

{
  "mcpServers": {
    "maclife": {
      "command": "npx",
      "args": ["-y","mcp-remote","https://chatbot.maclife.pl/mcp"]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config
Wklej JSON powyżej i zapisz
Zrestartuj Claude Desktop — ikona 🔧 potwierdzi połączenie

Claude Code

Terminal CLI

Natywny HTTP — bez proxy

Jedna komenda — Claude Code obsługuje Streamable HTTP bezpośrednio.

Terminal — zalecane

claude mcp add \
  --transport http \
  maclife \
  https://chatbot.maclife.pl/mcp

Alternatywnie — via mcp-remote

claude mcp add maclife \
  --command "npx" \
  --args "-y,mcp-remote,https://chatbot.maclife.pl/mcp"

Uruchom komendę w terminalu
Wpisz /mcp aby sprawdzić status

Cursor / Zed

Edytory kodu

Natywny HTTP — bez proxy

Edytory obsługują Streamable HTTP natywnie. Podaj URL i gotowe.

.cursor/mcp.json

{
  "mcpServers": {
    "maclife": {
      "url": "https://chatbot.maclife.pl/mcp",
      "type": "http"
    }
  }
}

Zed — settings.json

"context_servers": {
  "maclife": { "url": "https://chatbot.maclife.pl/mcp" }
}

Otwórz ustawienia MCP w edytorze
Wklej konfigurację i zapisz
Zrestartuj — narzędzia MacLife pojawią się w agencie

MacLife AI · Integracje

Połącz model AI
z bazą wiedzy MacLife

Udostępnij Claude, ChatGPT lub dowolnemu agentowi AI dostęp do aktualnych cenników, procedur serwisowych i możliwości składania zgłoszeń — w czasie rzeczywistym.

Szybka instalacja

Zainstaluj narzędzia MacLife w Claude

Jeden klik lub jedna komenda — baza wiedzy i zgłoszenia dostępne natywnie.

Dostępne narzędzia

przeszukaj_baze_wiedzy

Cenniki napraw, czasy realizacji, FAQ, procedury serwisowe — zawsze aktualne dane prosto z bazy MacLife.

wyslij_zgloszenie_naprawy

Złóż zgłoszenie door-to-door bezpośrednio z rozmowy z AI. Obsługa kuriera i Paczkomatu. Warszawa · Poznań.

info_o_serwisie

Lokalizacje, godziny pracy, numery kontaktowe. Status bazy wiedzy w czasie rzeczywistym.

Szczegółowa konfiguracja

Bezpłatny

Claude Desktop

Edytuj plik konfiguracyjny — narzędzia MacLife dostępne w każdej rozmowie. Wymaga Node.js.

via npx mcp-remote

claude_desktop_config.json

{
  "mcpServers": {
    "maclife": {
      "command": "npx",
      "args": ["-y","mcp-remote","https://chatbot.maclife.pl/mcp"]
    }
  }
}

Bezpłatny

Claude Code

Jedna komenda — natywny HTTP transport, bez proxy.

Natywny HTTP transport

Terminal

claude mcp add --transport http maclife https://chatbot.maclife.pl/mcp

ChatGPT Plus

ChatGPT Custom GPT

Stwórz własnego GPT z dostępem do MacLife — jeden URL, bez klucza API.

https://chatbot.maclife.pl/api/v1/openapi.json

chatgpt.com → Explore GPTs → Create → Configure → Actions
Import from URL — wklej adres OpenAPI powyżej
Authentication: None

REST API

REST API / Gemini / inne

Dowolny klient HTTP — bezpośrednie wywołania REST bez dodatkowej konfiguracji.

Baza wiedzy

POST https://chatbot.maclife.pl/api/v1/tools/baza
{ "zapytanie": "wymiana baterii iPhone 15" }

Przegląd API

MacLife udostępnia REST API i serwer MCP umożliwiające modelom AI dostęp do bazy wiedzy serwisowej, składanie zgłoszeń napraw i pobieranie informacji o placówkach.

—

Pliki bazy wiedzy

—

Fragmentów wiedzy

Narzędzia MCP

Endpointy REST

JSON

Format odpowiedzi

CORS

Cross-origin

Autoryzacja

Większość endpointów jest publiczna. Składanie zgłoszeń napraw wymaga klucza API.

PUBLICBaza wiedzy i informacje — bez autoryzacji

X-API-KeySkładanie zgłoszeń napraw

Nagłówek	Wartość	Opis
`X-API-Key`	`twój-klucz`	Wymagany do endpointu zgłoszeń
`Content-Type`	`application/json`	Wymagany dla POST

Base URL

https://chatbot.maclife.pl

Protokół: HTTPS Format: JSON CORS: *

GET /api/health

Status serwera i bazy wiedzy. Publiczny, bez autoryzacji.

GET/api/healthPUBLIC▼

curl

curl https://chatbot.maclife.pl/api/health

JavaScript

const r = await fetch('https://chatbot.maclife.pl/api/health');
const d = await r.json();
console.log(d.status); // "ok"

Python

import requests
r = requests.get('https://chatbot.maclife.pl/api/health')
print(r.json()['status'])  # ok

200OK

{"status":"ok","knowledge_base":{"ready":true,"files":8,"chunks":37},"tools_api":{"enabled":true}}

POST /api/v1/tools/baza

Przeszukuje bazę wiedzy MacLife. Zwraca dopasowane fragmenty z cenników, procedur i FAQ.

POST/api/v1/tools/bazaPUBLIC▼

Pole	Typ	Wymagane	Opis
`zapytanie`	`string`	wymagane	Pytanie w języku naturalnym

curl

curl -X POST https://chatbot.maclife.pl/api/v1/tools/baza \
  -H "Content-Type: application/json" \
  -d '{"zapytanie":"wymiana baterii iPhone 15"}'

JavaScript

const r = await fetch('https://chatbot.maclife.pl/api/v1/tools/baza', {
  method: 'POST',
  headers: {'Content-Type':'application/json'},
  body: JSON.stringify({zapytanie:'wymiana baterii iPhone 15'})
});
const d = await r.json();
console.log(d.result);

Python

import requests
r = requests.post(
    'https://chatbot.maclife.pl/api/v1/tools/baza',
    json={'zapytanie':'wymiana baterii iPhone 15'}
)
print(r.json()['result'])

200

{"tool":"przeszukaj_baze_wiedzy","result":"Wymiana baterii iPhone 15 — cena od 349 zł...","chunks_found":3}

GET /api/v1/tools/info

Informacje o serwisach MacLife: lokalizacje, godziny, kontakt.

GET/api/v1/tools/infoPUBLIC▼

curl

curl https://chatbot.maclife.pl/api/v1/tools/info

POST /api/v1/tools/zgloszenie

Składa zgłoszenie naprawy door-to-door. Wymaga klucza API.

POST/api/v1/tools/zgloszenieX-API-Key▼

Pole	Typ	Wymagane	Opis
`imie`	`string`	wymagane	Imię i nazwisko
`telefon`	`string`	wymagane	Numer telefonu
`email`	`string`	wymagane	Adres e-mail
`urzadzenie`	`string`	wymagane	Model urządzenia
`usterka`	`string`	wymagane	Opis usterki
`adres`	`string`	wymagane	Adres odbioru
`typ_wysylki`	`string`	opcjonalne	`kurier` lub `paczkomat`

curl

curl -X POST https://chatbot.maclife.pl/api/v1/tools/zgloszenie \
  -H "Content-Type: application/json" \
  -H "X-API-Key: twój-klucz-api" \
  -d '{"imie":"Jan Kowalski","telefon":"500 123 456","email":"jan@example.com","urzadzenie":"iPhone 15 Pro","usterka":"Pęknięty ekran","adres":"ul. Przykładowa 1, Warszawa"}'

200

{"tool":"wyslij_zgloszenie_naprawy","status":"accepted","numer_zgloszenia":"ML-2026-XXXX","message":"Zgłoszenie przyjęte. Kurier skontaktuje się w ciągu 24h."}

GET /api/v1/openapi.json

Schemat OpenAPI 3.0 do importu w ChatGPT, Gemini Extensions lub Postman.

GET/api/v1/openapi.jsonPUBLIC▼

curl

curl https://chatbot.maclife.pl/api/v1/openapi.json

Import w: ChatGPT Custom GPT Gemini Extensions Postman

Serwer MCP

MacLife implementuje protokół MCP w trybie Streamable HTTP. Każde wywołanie to osobny POST z JSON-RPC 2.0.

POST/mcpMCP 2024-11-05

Połączenie MCP

initialize

curl -X POST https://chatbot.maclife.pl/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"client","version":"1.0"}}}'

200

{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"maclife-serwis","version":"1.0.0"}}}

Narzędzia MCP

Dostępne narzędzia zwracane przez tools/list.

TOOLprzeszukaj_baze_wiedzyPUBLIC▼

Parametr: zapytanie (string, wymagane)

tools/call

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"przeszukaj_baze_wiedzy","arguments":{"zapytanie":"cena wymiany ekranu iPhone 14"}}}

TOOLinfo_o_serwisiePUBLIC▼

Nie wymaga parametrów. Zwraca informacje o serwisach.

TOOLwyslij_zgloszenie_naprawyX-API-Key▼

Parametry: imie telefon email urzadzenie usterka adres opcjonalnie: typ_wysylki

Kody błędów

Standardowe kody HTTP z polem error w JSON.

400

Bad Request — Brakujące lub nieprawidłowe pole w body.

401

Unauthorized — Brakujący lub nieprawidłowy X-API-Key.

404

Not Found — Endpoint nie istnieje.

405

Method Not Allowed — Niewłaściwa metoda HTTP.

500

Internal Server Error — Błąd serwera. Zawiera pole message.

503

Service Unavailable — Serwer tymczasowo niedostępny. Ponów po chwili.

FAQ

Jak podłączyć Claude Desktop do MacLife?+

Otwórz claude_desktop_config.json (Settings → Developer → Edit Config) i dodaj w sekcji mcpServers: "maclife": {"command":"npx","args":["-y","mcp-remote","https://chatbot.maclife.pl/mcp"]}Następnie zrestartuj Claude Desktop.

Czy API wymaga rejestracji?+

Endpointy bazy wiedzy i informacji o serwisie są w pełni publiczne. Klucz wymagany jest wyłącznie do składania zgłoszeń napraw.

Jak używać API z ChatGPT?+

chatgpt.com → Explore GPTs → Create → Configure → Actions → Import from URL: https://chatbot.maclife.pl/api/v1/openapi.json. ChatGPT nie obsługuje MCP — używa OpenAPI.

Czym różni się REST API od serwera MCP?+

REST API — standardowe wywołania HTTP, działa z każdym klientem. Idealne dla ChatGPT, Gemini, własnych integracji.

Serwer MCP — protokół Model Context Protocol, działa z Claude Desktop i Claude Code. Umożliwia wieloetapowe wywołania narzędzi w jednej sesji.

Czy jest limit wywołań API?+

Nie ma narzuconych limitów rate limiting dla publicznych endpointów. W przypadku intensywnego użycia skontaktuj się z MacLife.