Konfiguracja serwera MCP dla Claude, Cursora i innych klientów

Model Context Protocol (MCP) pozwala asystentom AI wywoływać ustrukturyzowane narzędzia zamiast odczytywać interfejs.

QuickBilling uruchamia hostowany zdalny serwer MCP pod adresem https://mcp.quickbilling.io/mcp (streamable HTTP). Dodajesz go do klienta MCP obsługującego zdalne serwery i logujesz się swoim kontem QuickBilling.

Co to oznacza w praktyce

• Asystent może tworzyć faktury, zapisywać wydatki, zarządzać klientami i pobierać raporty z poziomu czatu
• 149 narzędzi obejmujących fakturowanie, wydatki i raporty
• Logowanie działa przez OAuth 2.1 z PKCE i Twoje konto QuickBilling, a nie klucz API
• Każde wywołanie działa z uprawnieniami Twojego konta

Dla kogo: dla freelancerów i zespołów, które już pracują w Claude Desktop, Cursorze lub innym kliencie MCP i chcą fakturować bez przechodzenia do panelu.

Użyj REST API, gdy wbudowujesz fakturowanie we własny produkt lub proces automatyzacji. Klucze API są częścią planu Unlimited.

Użyj serwera MCP, gdy osoba pracuje z asystentem AI i chce mieć dostęp do tych samych danych w języku naturalnym.

QuickBilling MCP jest przeznaczony dla

• Claude Desktop, dodany jako niestandardowy zdalny konektor
• Cursor i innych klientów z obsługą zdalnych serwerów MCP
• Dowolnego klienta MCP, który obsługuje zdalne serwery z logowaniem OAuth

Każde narzędzie odpowiada rzeczywistemu, uwierzytelnionemu wywołaniu z uprawnieniami zalogowanego konta.

Wymagania: konto QuickBilling i klient MCP, który obsługuje zdalne serwery z logowaniem OAuth.

Kroki

1. Otwórz ustawienia swojego klienta MCP i dodaj zdalny serwer MCP
2. Użyj adresu https://mcp.quickbilling.io/mcp
3. Zaloguj się na swoje konto QuickBilling, gdy klient poprosi o autoryzację połączenia
4. Zapytaj asystenta: „Wypisz moje obszary robocze QuickBilling” albo „Które faktury są po terminie?”

Klucz API nie jest potrzebny. Jeśli Twoje konto ma więcej niż jeden obszar roboczy, poproś asystenta o ich listę i wybierz jeden.

Kroki

1. Otwórz Claude Desktop i przejdź do Ustawienia, a potem Konektory
2. Wybierz Dodaj niestandardowy konektor
3. Nazwij go QuickBilling i wklej adres https://mcp.quickbilling.io/mcp
4. Wybierz Połącz i zaloguj się na swoje konto QuickBilling w oknie przeglądarki, które się otworzy
5. W nowym czacie włącz konektor QuickBilling i zapytaj: „Wypisz moje obszary robocze QuickBilling”

Nazwy menu mogą się zmieniać między wersjami Claude Desktop, a niestandardowe konektory mogą zależeć od Twojego planu Claude.

Kroki

1. Otwórz Ustawienia Cursora, a potem sekcję MCP
2. Wybierz dodanie nowego serwera MCP. Cursor otworzy plik mcp.json
3. Dodaj wpis o nazwie quickbilling z adresem url https://mcp.quickbilling.io/mcp, jak w minimalnej konfiguracji w Szybkim starcie
4. Zapisz plik. Gdy Cursor poprosi o logowanie, dokończ je w przeglądarce
5. W czacie Agent zapytaj: „Które faktury są po terminie?”

Aby używać serwera tylko w jednym projekcie, umieść ten sam wpis w pliku .cursor/mcp.json wewnątrz tego projektu.

• Adres serwera: https://mcp.quickbilling.io/mcp
• Transport: streamable HTTP, zdalny serwer, nic nie trzeba instalować
• Uwierzytelnianie: OAuth 2.1 z PKCE, logowanie na konto QuickBilling
• Wykrywanie: metadane chronionego zasobu OAuth są dostępne pod /.well-known/oauth-protected-resource na tym samym hoście

Zdalny serwer nie przyjmuje kluczy API. Klucze API służą do REST API i są częścią planu Unlimited: zobacz https://quickbilling.io/docs/api

Jeśli Twoje konto ma jeden obszar roboczy, asystent używa go bez żadnej konfiguracji.

Jeśli masz kilka, poproś asystenta o listę obszarów roboczych i wybierz jeden.

Narzędzia do obszarów roboczych

• list_workspaces, zwraca Twoje obszary robocze
• get_active_workspace, pokazuje używany obszar roboczy
• set_active_workspace, wybiera obszar roboczy dla kolejnych wywołań

Serwer udostępnia 149 narzędzi

• Faktury i oferty (19): lista, pobieranie, tworzenie, zapisywanie, usuwanie, duplikowanie, przekształcanie oferty w fakturę, ponowne wystawienie, status, oznaczanie jako opłacone, podgląd i wysyłka e-mailem, linki do udostępnienia, link do PDF, aktywność, analityka wyświetleń, przypomnienia
• Faktury cykliczne (7): lista, pobieranie, tworzenie, aktualizacja, wstrzymywanie, wznawianie, usuwanie
• Klienci (8): lista, wyszukiwanie, pobieranie, zestawienie, tworzenie, szybkie tworzenie, aktualizacja, usuwanie
• Profile rozliczeniowe i biblioteka pozycji (7)
• Szablony (6): lista szablonów, szablony wbudowane, domyślny, pobieranie, ustawianie domyślnego, gotowe ustawienia
• Wydatki (23): lista, pobieranie, tworzenie (jednego lub kilku), aktualizacja, usuwanie, przesyłanie, ponowne przesłanie, zatwierdzanie, odrzucanie, oznaczanie jako opłacone, anulowanie, akcje zbiorcze, wydatki do refakturowania, linki do faktur, załączniki i pliki paragonów, aktywność
• Raporty wydatków (9): statystyki, podsumowanie, miesięczne, kwartalne, roczne, trendy, analiza kosztów, wydatki, podlegające odliczeniu
• Kategorie, dostawcy i tagi (12)
• Budżety (5), wydatki cykliczne (7) i przychody (6)
• Projekty i kamienie milowe (10), w tym fakturowanie kamienia milowego
• Priorytety, raporty i wyszukiwanie (4): co wymaga uwagi, zestawienie dzienne, tygodniowe i miesięczne, osobiste sprawdzenie finansów, wyszukiwanie w obszarze roboczym
• Szybkie zapisywanie wydatków zwykłymi słowami (1): quick_log_expenses zapisuje do 25 wydatków z prostego opisu
• Powiadomienia (2): list_notifications, mark_notifications_read
• Raporty HTML (9): tworzenie, wysyłanie, lista, pobieranie, aktualizacja, udostępnianie linkiem, wysyłka e-mailem, unieważnianie udostępnienia, usuwanie
• Raporty i pulpity (7): statystyki przeglądu, raporty obszaru roboczego, rachunek zysków i strat, przepływy pieniężne, zysk według klienta, rentowność klienta, pozycja netto
• Obszar roboczy i profil (5): get_profile, list_workspaces, get_active_workspace, set_active_workspace i attach_receipt_to_expense
• Ustawienia obszaru roboczego (1): get_workspace_settings
• Zużycie planu (1): get_subscription_usage

Niedostępne przez MCP: członkowie zespołu i zaproszenia, eksport konta, plany subskrypcji, projektowanie szablonów, palety kolorów oraz wysyłanie awatara lub logo. Te rzeczy zrobisz w aplikacji internetowej.

Te same dane są dostępne przez REST API: https://quickbilling.io/docs/api

Utworzenie i wysłanie faktury

„Utwórz fakturę dla Bluebird Café na 3 godziny projektowania po 120 USD za godzinę i ją wyślij.” Asystent znajduje albo dodaje klienta, tworzy fakturę i wysyła ją e-mailem.

Zapisz wydatek z paragonem

„Zapisz ten paragon jako wydatek na Oprogramowanie.” Asystent odczytuje paragon i tworzy wydatek w tej kategorii. Pliki udostępnione w czacie nie są przechowywane przez QuickBilling. Aby zachować oryginał przy wydatku, poproś o link do przesłania pliku, czyli podpisany link działający przez 30 minut.

Sprawdź, co jest po terminie

„Które faktury są po terminie?” Asystent wypisuje nieopłacone faktury, których termin płatności minął.

Praca w kilku obszarach roboczych

„Wypisz moje obszary robocze i przełącz się na Northwind Studio.” Potem kontynuuj z prośbami o faktury lub wydatki.

• Logowanie działa przez OAuth z Twoim kontem QuickBilling, a zdalny serwer nie przyjmuje kluczy API
• Każde wywołanie działa z uprawnieniami Twojego konta, również przy zmianie i usuwaniu rekordów
• Sprawdź, co asystent proponuje, zanim potwierdzisz zmianę
• Aby zatrzymać dostęp, usuń połączenie w swoim kliencie MCP
• To, co asystent robi z otrzymanymi danymi, reguluje polityka prywatności jego dostawcy. Zobacz sekcję o asystentach AI w polityce prywatności.

Klient nie może się połączyć

Sprawdź, czy Twój klient obsługuje zdalne serwery MCP z logowaniem OAuth i czy adres to dokładnie https://mcp.quickbilling.io/mcp.

Krok logowania się nie kończy

Usuń serwer z klienta, dodaj go ponownie i postępuj zgodnie z monitem logowania na swoje konto QuickBilling.

Nieprawidłowe dane obszaru roboczego

Zapytaj asystenta, który obszar roboczy jest aktywny, potem wypisz swoje obszary robocze i wybierz właściwy.

Więcej pomocy: https://quickbilling.io/contact, info@quickbilling.io