Serwer MCP
Serwer MCP DragApp udostępnia 47 narzędzi w 12 kategoriach, dając każdemu klientowi AI zgodnemu z MCP pełny dostęp do Twoich tablic, e-maili, kart, kontaktów, bazy wiedzy, analityki i automatyzacji.
Połącz się na dwa sposoby: wklej adres URL hostowanego endpointu w ustawieniach konektorów klienta AI (najszybsza droga, bez instalacji) albo uruchom serwer open source lokalnie z pliku konfiguracyjnego. W obu przypadkach te same narzędzia i te same uprawnienia.
Zbudowany na standardzie Model Context Protocol (MCP). Open source, licencja MIT.
Połączenie (endpoint hostowany)
Najszybciej połączysz się przez hostowany endpoint. Trzy kroki, około dwóch minut. Bez pliku konfiguracyjnego, bez lokalnej instalacji, bez restartu.
- Dodaj konektor. W ustawieniach konektorów Twojego klienta AI (w Claude: Ustawienia › Konektory › Dodaj własny konektor), wklej ten adres URL i zapisz:Adres URL konektora
https://app.dragapp.com/mcp - Kliknij Połącz. W przeglądarce otwiera się strona połączenia Drag z prośbą o klucz API DragApp.
- Wpisz swój klucz API. Skopiuj go w DragApp w sekcji Ustawienia › Integracje, wklej go na stronie połączenia i zatwierdź. Drag weryfikuje klucz i przekazuje go Twojemu klientowi jako token dostępu. Połączenie jest aktywne.
Aby to sprawdzić, poproś klienta: „Wyświetl tablice w moim DragApp”. Przy pierwszym użyciu każdego narzędzia poprosi Cię o zgodę, więc dokładnie kontrolujesz, co może robić.
Klucz wpisujesz tylko raz, wyłącznie na stronie połączenia. Nigdy nie pojawia się w adresie strony, a usługa MCP nie przechowuje niczego na swoich serwerach.
Pod spodem to standardowy przepływ OAuth 2.1 z kodem autoryzacji, PKCE i dynamiczną rejestracją klienta, obsługiwany przez transport Streamable HTTP protokołu MCP, więc połączyć się może każdy klient obsługujący zdalne konektory MCP.
Instalacja (ścieżka lokalna)
Wolisz uruchomić serwer samodzielnie albo korzystasz z klienta z plikiem konfiguracyjnym, takiego jak Cursor, Windsurf czy Claude Code? Pakiet npm jest nadal w pełni wspierany. Uruchom go bezpośrednio przez npx, bez instalacji:
npx -y @dragapp/mcp-serverAlbo zainstaluj globalnie:
npm install -g @dragapp/mcp-serverUwierzytelnianie
Obie metody uwierzytelniają się Twoim kluczem API DragApp, a połączenie w obu przypadkach dziedziczy Twoje obecne uprawnienia w Drag. W przypadku endpointu hostowanego wpisujesz klucz raz na bezpiecznej stronie połączenia i staje się on tokenem dostępu Twojego klienta; usługa MCP niczego nie przechowuje. W przypadku metody lokalnej serwer odczytuje klucz ze zmiennej środowiskowej DRAG_API_KEY.
Pobierz klucz API w sekcji Ustawienia, a następnie Integracje, w Drag. Możesz go tam w każdej chwili unieważnić.
Twój klucz API daje pełny dostęp do Twojej przestrzeni roboczej DragApp. Zachowaj go w tajemnicy i nigdy nie umieszczaj go w systemie kontroli wersji.
Konfiguracja klienta
Dodaj poniższy JSON do pliku konfiguracji MCP swojego klienta AI:
{
"mcpServers": {
"dragapp": {
"command": "npx",
"args": ["-y", "@dragapp/mcp-server"],
"env": {
"DRAG_API_KEY": "your-api-key"
}
}
}
}Lokalizacje pliku konfiguracyjnego
| Klient | Ścieżka konfiguracji |
|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Cursor | .cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Claude Code | ~/.claude.json lub .mcp.json |
Dokumentacja narzędzi
47 narzędzi w 12 kategoriach. Każde narzędzie jest automatycznie dostępne dla każdego podłączonego klienta MCP.
| Narzędzie | Opis |
|---|---|
list_threads | Wyświetla wątki e-mail w określonej kolumnie tablicy |
get_thread | Pobiera pojedynczą wiadomość e-mail z pełną treścią HTML |
reply_to_thread | Odpowiada w istniejącym wątku e-mail |
send_new_email | Wysyła nowy e-mail z tablicy |
search_threads | Wyszukuje wątki na wszystkich tablicach |
filter_threads | Filtruje wątki według etykiety, osoby odpowiedzialnej lub statusu |
move_thread | Przenosi wątek do innej kolumny |
move_threads_bulk | Przenosi wiele wątków naraz |
Tablice
5| Narzędzie | Opis |
|---|---|
list_boards | Wyświetla wszystkie tablice, do których uwierzytelniony użytkownik ma dostęp |
get_board | Pobiera szczegóły określonej tablicy |
list_columns | Wyświetla wszystkie kolumny na tablicy |
list_board_members | Wyświetla wszystkich członków tablicy |
list_teams | Wyświetla wszystkie zespoły w przestrzeni roboczej |
Karty
6| Narzędzie | Opis |
|---|---|
list_cards_in_column | Wyświetla wszystkie karty w określonej kolumnie |
get_card | Pobiera szczegóły określonej karty |
create_card | Tworzy nową kartę w kolumnie |
update_card | Aktualizuje właściwości karty (tytuł, opis, osoba odpowiedzialna, termin) |
move_card | Przenosi kartę do innej kolumny lub na inną pozycję |
archive_card | Archiwizuje kartę |
Etykiety
4| Narzędzie | Opis |
|---|---|
list_labels | Wyświetla wszystkie etykiety Gmaila dostępne na tablicy |
add_label_to_thread | Dodaje etykietę do wątku e-mail |
remove_label_from_thread | Usuwa etykietę z wątku e-mail |
toggle_labels | Przełącza widoczność etykiet na tablicy |
Komentarze
2| Narzędzie | Opis |
|---|---|
add_comment | Dodaje komentarz wewnętrzny do karty lub wątku |
get_comment | Pobiera szczegóły określonego komentarza |
Zadania
1| Narzędzie | Opis |
|---|---|
create_task | Tworzy zadanie (pozycję listy kontrolnej) na karcie |
Kontakty
3| Narzędzie | Opis |
|---|---|
search_contacts | Wyszukuje kontakty po nazwie lub adresie e-mail |
get_contact_conversations | Pobiera wszystkie rozmowy z określonym kontaktem |
create_contact | Tworzy nowy kontakt w przestrzeni roboczej |
Baza wiedzy
5| Narzędzie | Opis |
|---|---|
list_articles | Wyświetla wszystkie artykuły w bazie wiedzy |
get_article | Pobiera pełną treść artykułu z bazy wiedzy |
create_article | Tworzy nowy artykuł w bazie wiedzy |
update_article | Aktualizuje istniejący artykuł w bazie wiedzy |
search_knowledge | Przeszukuje bazę wiedzy według zapytania |
Analityka
4| Narzędzie | Opis |
|---|---|
get_response_times | Pobiera wskaźniki czasu odpowiedzi dla tablicy |
get_avg_response_time | Pobiera średni czas odpowiedzi dla wszystkich tablic |
get_daily_activity | Pobiera dzienne wskaźniki aktywności (wątki utworzone, z odpowiedzią, rozwiązane) |
get_closed_activity | Pobiera wskaźniki zamkniętych/rozwiązanych wątków |
Automatyzacje
3| Narzędzie | Opis |
|---|---|
list_automations | Wyświetla wszystkie automatyzacje skonfigurowane na tablicy |
toggle_automation | Włącza lub wyłącza wybraną automatyzację |
toggle_ai_drafts | Włącza lub wyłącza generowanie wersji roboczych przez AI na tablicy |
| Narzędzie | Opis |
|---|---|
get_whatsapp_conversation | Pobiera pełną historię wiadomości rozmowy WhatsApp (karty) na tablicy WhatsApp. Zwraca wiadomości czatu w kolejności. Użyj cardId zwróconego przez list_threads / search_threads na tablicy WhatsApp (pole `cardId`). |
list_whatsapp_templates | Wyświetla wstępnie zatwierdzone szablony wiadomości WhatsApp dostępne na tablicy WhatsApp. Zwraca nazwę, język, status, kategorię i treść każdego szablonu oraz liczbę oczekiwanych zmiennych {{n}}. Wysłać można tylko szablony APPROVED. |
send_whatsapp_message | Wysyła wiadomość WhatsApp z dowolnym tekstem w istniejącej rozmowie. Uwaga: WhatsApp pozwala na wiadomości z dowolnym tekstem tylko w 24-godzinnym oknie obsługi klienta; poza nim użyj send_whatsapp_template. |
send_whatsapp_template | Wysyła w rozmowie wiadomość z wcześniej zatwierdzonego szablonu WhatsApp. Użyj tego, by skontaktować się z kimś poza 24-godzinnym oknem. Najpierw wywołaj list_whatsapp_templates, aby uzyskać dokładną nazwę i język szablonu oraz sprawdzić, ilu zmiennych {{n}} wymaga. |
Przykłady
Polecenia w języku naturalnym i narzędzia, które klient AI wywoła w tle.
“Pokaż nieprzeczytane e-maile na tablicy Wsparcie”
list_boards → list_columns → list_threads
Klient AI znajduje tablicę Wsparcie, wskazuje właściwą kolumnę i wyświetla wątki z tematami, nadawcami i znacznikami czasu.
“Odpowiedz na najnowszy e-mail od Anny”
search_threads → get_thread → reply_to_thread
Wyszukuje wątki od Anny na wszystkich tablicach, pobiera pełną wiadomość, a następnie pisze i wysyła odpowiedź.
“Jaki jest nasz średni czas odpowiedzi w tym tygodniu?”
get_avg_response_time
Bezpośrednio wywołuje narzędzie analityczne, aby zwrócić średni czas odpowiedzi z porównaniem okresów.
“Utwórz kartę na tablicy Sprint z tym zgłoszeniem błędu”
list_boards → list_columns → create_card
Znajduje tablicę Sprint, wybiera właściwą kolumnę (np. Backlog) i tworzy kartę ze szczegółami błędu.
“Przypisz Annie wszystkie wątki dotyczące rozliczeń”
filter_threads → move_threads_bulk
Filtruje wątki z etykietą PŁATNOŚCI, a następnie zbiorczo przenosi je do kolumny przypisanej do Anny.
“Znajdź w naszej bazie wiedzy zasady zwrotów”
search_knowledge
Przeszukuje bazę wiedzy i zwraca pasujące artykuły z fragmentami.
Programowanie
Sklonuj repozytorium i uruchom lokalnie:
git clone https://github.com/nick-timms/drag-mcp-server.git
cd drag-mcp-server
npm install
npm run build
DRAG_API_KEY=your-key node dist/index.jsDo pracy deweloperskiej z automatyczną przebudową:
npm run devLinki
Repozytorium GitHub: kod źródłowy, zgłoszenia, współtworzenie
Pakiet npm: @dragapp/mcp-server
Model Context Protocol: specyfikacja MCP
Dokumentacja REST API: dokumentacja REST API DragApp
Licencja: MIT
Potrzebujesz pomocy?
Centrum pomocy: przewodniki i samouczki
support@dragapp.com: wsparcie przez e-mail
Zgłoszenia na GitHubie: zgłoszenia błędów i propozycje funkcji
