Integracja MCP
Model Context Protocol dla asystentów AI
Model Context Protocol (MCP) to otwarty standard wprowadzony przez Anthropic, który pozwala asystentom AI (takim jak Claude, Cursor, VS Code Copilot) na integrację z zewnętrznymi narzędziami i źródłami danych.
Jak to działa
Asystent AI komunikuje się z serwerem MCP przez protokół STDIO, a serwer MCP wykonuje operacje na NetSendo za pomocą API REST v1.
┌─────────────────┐ STDIO ┌─────────────────┐ HTTP/S ┌─────────────────┐ │ Claude/Cursor │ ◄──────────► │ MCP Server │ ◄───────────► │ NetSendo │ │ (AI Client) │ │ (Docker/npx) │ │ (Your inst.) │ └─────────────────┘ └─────────────────┘ └─────────────────┘
Instalacja
Wymagania
- Node.js 18+
- Klucz API z NetSendo
Kroki
- Wygeneruj klucz API: Ustawienia → Klucze API
- Zainstaluj Node.js ze strony nodejs.org
- Skonfiguruj narzędzie AI używając poniższej konfiguracji
{
"mcpServers": {
"netsendo": {
"command": "npx",
"args": [
"-y",
"@netsendo/mcp-client",
"--url",
"https://your-domain.com",
"--api-key",
"YOUR_API_KEY"
]
}
}
}Zamień https://your-domain.com na adres URL Twojej instancji NetSendo oraz YOUR_API_KEY na wygenerowany klucz API.
Lokalizacje plików konfiguracyjnych
| Klient | Lokalizacja pliku |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor IDE | Ustawienia → MCP → Dodaj serwer |
| VS Code | .vscode/mcp.json |
Wspierani klienci AI
Oficjalna aplikacja desktopowa Claude od Anthropic
IDE z wbudowanym AI dla programistów
Visual Studio Code z rozszerzeniem MCP
Dostępne funkcje
Subskrybenci
Zarządzaj kontaktami – dodawaj, edytuj, usuwaj
Listy kontaktów
Przeglądaj i organizuj listy mailingowe
Wiadomości Email
Wysyłaj spersonalizowane wiadomości e-mail
Wiadomości SMS
Wysyłaj wiadomości SMS do kontaktów
Tagi
Kategoryzuj subskrybentów za pomocą tagów
Statystyki
Sprawdzaj statystyki konta i dostarczalności
Dostępne narzędzia
Zarządzanie subskrybentami
| Narzędzie | Opis |
|---|---|
| list_subscribers | Lista subskrybentów z filtrowaniem i paginacją |
| get_subscriber | Pobierz subskrybenta po ID lub e-mail |
| create_subscriber | Utwórz nowego subskrybenta |
| update_subscriber | Zaktualizuj dane subskrybenta |
| delete_subscriber | Usuń subskrybenta |
| sync_subscriber_tags | Synchronizuj tagi subskrybenta |
Listy kontaktów i tagi
| Narzędzie | Opis |
|---|---|
| list_contact_lists | Pobierz wszystkie listy kontaktów |
| get_contact_list | Pobierz szczegóły listy |
| get_list_subscribers | Pobierz subskrybentów z listy |
| list_tags | Pobierz wszystkie dostępne tagi |
| list_custom_fields | Pobierz definicje niestandardowych pól |
Wiadomości
| Narzędzie | Opis |
|---|---|
| list_mailboxes | Pobierz dostępne skrzynki pocztowe |
| send_email | Wyślij e-mail do subskrybenta |
| get_email_status | Sprawdź status dostarczenia e-maila |
| list_sms_providers | Pobierz dostępnych dostawców SMS |
| send_sms | Wyślij wiadomość SMS |
| get_sms_status | Sprawdź status dostarczenia SMS |
Konto
| Narzędzie | Opis |
|---|---|
| test_connection | Testuj połączenie API |
| get_account_info | Pobierz informacje o koncie |
Przykładowe zapytania
Bezpieczeństwo
Rozwiązywanie problemów
- Upewnij się, że NetSendo jest uruchomiony i dostępny
- Sprawdź, czy klucz API jest prawidłowy
- Zweryfikuj poprawność URL-a (uwzględnij https://)
Uruchom ponownie narzędzie AI po zmianach konfiguracji.
Zainstaluj Node.js ze strony nodejs.org (zawiera npm/npx).
Wiele instancji NetSendo
Możesz połączyć się z wieloma instancjami NetSendo, używając różnych nazw serwerów:
{
"mcpServers": {
"netsendo-production": {
"command": "npx",
"args": ["-y", "@netsendo/mcp-client", "--url", "https://app.company.com", "--api-key", "prod-key"]
},
"netsendo-staging": {
"command": "npx",
"args": ["-y", "@netsendo/mcp-client", "--url", "https://staging.company.com", "--api-key", "staging-key"]
}
}
}