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.

  1. 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
  2. Kliknij Połącz. W przeglądarce otwiera się strona połączenia Drag z prośbą o klucz API DragApp.
  3. 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:

Terminal
npx -y @dragapp/mcp-server

Albo zainstaluj globalnie:

Terminal
npm install -g @dragapp/mcp-server

Uwierzytelnianie

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:

Konfiguracja MCP
{
  "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.

E-mail

8
NarzędzieOpis
list_threadsWyświetla wątki e-mail w określonej kolumnie tablicy
get_threadPobiera pojedynczą wiadomość e-mail z pełną treścią HTML
reply_to_threadOdpowiada w istniejącym wątku e-mail
send_new_emailWysyła nowy e-mail z tablicy
search_threadsWyszukuje wątki na wszystkich tablicach
filter_threadsFiltruje wątki według etykiety, osoby odpowiedzialnej lub statusu
move_threadPrzenosi wątek do innej kolumny
move_threads_bulkPrzenosi wiele wątków naraz

Tablice

5
NarzędzieOpis
list_boardsWyświetla wszystkie tablice, do których uwierzytelniony użytkownik ma dostęp
get_boardPobiera szczegóły określonej tablicy
list_columnsWyświetla wszystkie kolumny na tablicy
list_board_membersWyświetla wszystkich członków tablicy
list_teamsWyświetla wszystkie zespoły w przestrzeni roboczej

Karty

6
NarzędzieOpis
list_cards_in_columnWyświetla wszystkie karty w określonej kolumnie
get_cardPobiera szczegóły określonej karty
create_cardTworzy nową kartę w kolumnie
update_cardAktualizuje właściwości karty (tytuł, opis, osoba odpowiedzialna, termin)
move_cardPrzenosi kartę do innej kolumny lub na inną pozycję
archive_cardArchiwizuje kartę

Etykiety

4
NarzędzieOpis
list_labelsWyświetla wszystkie etykiety Gmaila dostępne na tablicy
add_label_to_threadDodaje etykietę do wątku e-mail
remove_label_from_threadUsuwa etykietę z wątku e-mail
toggle_labelsPrzełącza widoczność etykiet na tablicy

Komentarze

2
NarzędzieOpis
add_commentDodaje komentarz wewnętrzny do karty lub wątku
get_commentPobiera szczegóły określonego komentarza

Tagi

2
NarzędzieOpis
list_tagsWyświetla wszystkie tagi w przestrzeni roboczej
add_tag_to_cardDodaje tag do karty

Zadania

1
NarzędzieOpis
create_taskTworzy zadanie (pozycję listy kontrolnej) na karcie

Kontakty

3
NarzędzieOpis
search_contactsWyszukuje kontakty po nazwie lub adresie e-mail
get_contact_conversationsPobiera wszystkie rozmowy z określonym kontaktem
create_contactTworzy nowy kontakt w przestrzeni roboczej

Baza wiedzy

5
NarzędzieOpis
list_articlesWyświetla wszystkie artykuły w bazie wiedzy
get_articlePobiera pełną treść artykułu z bazy wiedzy
create_articleTworzy nowy artykuł w bazie wiedzy
update_articleAktualizuje istniejący artykuł w bazie wiedzy
search_knowledgePrzeszukuje bazę wiedzy według zapytania

Analityka

4
NarzędzieOpis
get_response_timesPobiera wskaźniki czasu odpowiedzi dla tablicy
get_avg_response_timePobiera średni czas odpowiedzi dla wszystkich tablic
get_daily_activityPobiera dzienne wskaźniki aktywności (wątki utworzone, z odpowiedzią, rozwiązane)
get_closed_activityPobiera wskaźniki zamkniętych/rozwiązanych wątków

Automatyzacje

3
NarzędzieOpis
list_automationsWyświetla wszystkie automatyzacje skonfigurowane na tablicy
toggle_automationWłącza lub wyłącza wybraną automatyzację
toggle_ai_draftsWłącza lub wyłącza generowanie wersji roboczych przez AI na tablicy

WhatsApp

4
NarzędzieOpis
get_whatsapp_conversationPobiera 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_templatesWyś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_messageWysył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_templateWysył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:

Terminal
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.js

Do pracy deweloperskiej z automatyczną przebudową:

Terminal
npm run dev

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