Konfiguracja MCP

Serwery Model Context Protocol (MCP) transformują Cursor z edytora kodu w kompleksową platformę rozwojową. W tym 10-minutowym przewodniku skonfigurujesz podstawowe serwery MCP które integrują dokumentację, automatyzację przeglądarki, kontrolę wersji i więcej.

Zrozumienie MCP

Wskazówka

Myśl o serwerach MCP jak o supermocach dla twojego AI - dają Cursor możliwości poza edycją kodu, jak przeglądanie internetu, odpytywanie baz danych czy dostęp do dokumentacji.

Co umożliwia MCP

Dostęp do dokumentacji

Dostęp w czasie rzeczywistym do najnowszych dokumentów bibliotek zapobiegający przestarzałym sugestiom kodu

Automatyzacja przeglądarki

Testuj aplikacje webowe, rób zrzuty ekranu i automatyzuj zadania przeglądarki

Operacje bazy danych

Odpytuj bazy danych, sprawdzaj schematy i zarządzaj danymi bezpośrednio

Serwisy zewnętrzne

Łącz się z API, narzędziami zarządzania projektami i usługami zewnętrznymi

Wymagania wstępne

1. Sprawdź Node.js 18+:

   node --version  # Powinno pokazać v18.0.0 lub wyżej

2. Sprawdź npm:

   npm --version  # Powinno być 8.0.0 lub wyżej

3. Utwórz katalog konfiguracji MCP:

   mkdir -p ~/.cursor
   touch ~/.cursor/mcp.json

Podstawowe serwery MCP

1. Context7 - dostęp do dokumentacji

Dlaczego Context7?

Dostęp do aktualnej dokumentacji dla 4,000+ bibliotek. Koniec z przestarzałym kodem ze Stack Overflow!

Instalacja

Instalacja jednym kliknięciem

Dodaj Context7 do Cursor

Kliknij link powyżej aby automatycznie zainstalować Context7

Instalacja ręczna

Dodaj do ~/.cursor/mcp.json:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}

Przykłady użycia

# Pobierz najnowsze dokumenty Next.js
"Jak używać nowego App Router w Next.js? Użyj context7"

# Naucz się API bibliotek
"Pokaż mi jak używać React Query do pobierania danych z context7"

# Porównania frameworków
"Porównaj Vue 3 Composition API z React Hooks używając context7"

2. Puppeteer - automatyzacja przeglądarki

Dlaczego Puppeteer?

Automatyzuj testowanie przeglądarki, rób zrzuty ekranu, scrapuj dane i testuj przepływy użytkownika.

Instalacja

Konfiguracja globalna

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Konfiguracja projektu

Utwórz .cursor/mcp.json w swoim projekcie:

{
  "mcpServers": {
    "puppeteer": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-puppeteer"]
    }
  }
}

Konfiguracja pierwszego uruchomienia

Notatka

Puppeteer pobierze Chromium (~170MB) przy pierwszym uruchomieniu. To normalne i dzieje się tylko raz.

Przykłady użycia

1. Testowanie zrzutów ekranu:

   "Przejdź do localhost:3000 i zrób zrzut ekranu strony głównej"

2. Testowanie E2E:

   "Przetestuj przepływ logowania: idź do /login, wprowadź test@example.com
   i password123, kliknij submit, sprawdź przekierowanie do /dashboard"

3. Regresja wizualna:

   "Zrób zrzuty ekranu wszystkich głównych stron i porównaj ze
   zrzutami w /tests/visual-baseline"

3. Filesystem - zaawansowane operacje na plikach

Dlaczego Filesystem?

Wykonuj zaawansowane operacje na plikach poza workspace, masowe zarządzanie plikami i integrację systemową.

Instalacja

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    }
  }
}

Konfiguracja bezpieczeństwa

Rozwój

Pozwól na szerszy dostęp dla rozwoju:

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem"],
    "env": {
      "ALLOWED_PATHS": "/Users/dev/projects,/tmp"
    }
  }
}

Produkcja

Ogranicz do konkretnych katalogów:

{
  "filesystem": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem"],
    "env": {
      "ALLOWED_PATHS": "/app/data",
      "READ_ONLY": "true"
    }
  }
}

4. Integracja GitHub

Dlaczego GitHub MCP?

Zarządzaj zgłoszeniami, PR i operacjami repozytorium bez opuszczania Cursor.

Instalacja

Używając gh CLI

Najpierw zainstaluj GitHub CLI:

# macOS
brew install gh

# Windows
winget install GitHub.cli

# Linux
sudo apt install gh

Następnie uwierzytelnij:

gh auth login

Serwer MCP

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "twoj-token-tutaj"
      }
    }
  }
}

Przykłady użycia

# Utwórz zgłoszenie
"Utwórz zgłoszenie GitHub zatytułowane 'Dodaj tryb ciemny' z etykietami: enhancement, ui"

# Zarządzanie PR
"Wylistuj wszystkie otwarte PR i podsumuj ich status"

# Przegląd kodu
"Przejrzyj najnowszy PR i skomentuj wszelkie potencjalne problemy"

5. Połączenia bazy danych

Dlaczego Database MCP?

Odpytuj dane, sprawdzaj schematy i zarządzaj operacjami bazy danych bezpośrednio z Cursor.

Konfiguracja PostgreSQL

1. Zainstaluj serwer:

   {
     "mcpServers": {
       "postgres": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-postgres",
           "postgresql://user:pass@localhost:5432/dbname"
         ]
       }
     }
   }

2. Bezpieczne poświadczenia:

   {
     "postgres": {
       "command": "npx",
       "args": ["-y", "@modelcontextprotocol/server-postgres"],
       "env": {
         "DATABASE_URL": "postgresql://user:pass@localhost:5432/dbname"
       }
     }
   }

Inne bazy danych

MySQL

{
  "mysql": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-mysql",
      "mysql://user:pass@localhost:3306/dbname"
    ]
  }
}

SQLite

{
  "sqlite": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-sqlite",
      "/path/to/database.db"
    ]
  }
}

MongoDB

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "@modelcontextprotocol/server-mongodb",
      "mongodb://localhost:27017/mydb"
    ]
  }
}

Integracje zarządzania projektami

Linear

Integracja Linear

Synchronizuj zadania, twórz zgłoszenia i aktualizuj status projektu bez przełączania kontekstu.

Notatka

Linear oferuje teraz zdalny serwer MCP. Pakiet npm jest przestarzały.

{
  "mcpServers": {
    "linear": {
      "url": "https://mcp.linear.app/sse"
    }
  }
}

Dla starszego pakietu npm (przestarzały):

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "linear-mcp-server"],
      "env": {
        "LINEAR_API_KEY": "twoj-klucz-api"
      }
    }
  }
}

Jira

Notatka

Atlassian oferuje zdalny serwer MCP (Beta) pod https://mcp.atlassian.com/v1/sse z uwierzytelnianiem OAuth. Do konfiguracji lokalnej używaj pakietów społeczności.

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@mcp-devtools/jira"],
      "env": {
        "JIRA_URL": "https://firma.atlassian.net",
        "JIRA_EMAIL": "ty@firma.com",
        "JIRA_API_TOKEN": "twoj-token"
      }
    }
  }
}

Alternatywnie użyj @aot-tech/jira-mcp-server.

Integracja narzędzi projektowych

Figma

Integracja Figma

Konwertuj projekty na kod, wyciągaj tokeny projektowe i utrzymuj spójność projektową.

{
  "mcpServers": {
    "figma": {
      "command": "npx",
      "args": ["-y", "figma-mcp-server"],
      "env": {
        "FIGMA_ACCESS_TOKEN": "twoj-token"
      }
    }
  }
}

Alternatywnie użyj figma-developer-mcp dla rozszerzonych funkcji.

Użycie:

"Pobierz paletę kolorów z naszego systemu projektowego w Figma"
"Konwertuj ramkę LoginScreen na komponenty React"

Przykład kompletnej konfiguracji

Oto kompleksowy ~/.cursor/mcp.json ze wszystkimi podstawowymi serwerami:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    },
    "puppeteer": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-puppeteer"]
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DATABASE_URL}"
      }
    },
    "linear": {
      "url": "https://mcp.linear.app/sse"
    }
  }
}

Weryfikacja instalacji

Sprawdź status MCP

1. Otwórz ustawienia Cursor: Cmd/Ctrl + Shift + J

2. Przejdź do: Narzędzia i integracje → Model Context Protocol

3. Sprawdź status:

   • Zielona kropka = działa
   • Czerwona kropka = błąd (sprawdź logi)
   • Szara = nie uruchomiony

4. Testuj każdy serwer:

   # Testuj Context7
   "Co nowego w React 19? Użyj context7"
   
   # Testuj Puppeteer
   "Przejdź do google.com i zrób zrzut ekranu"
   
   # Testuj GitHub
   "Wylistuj moje ostatnie zgłoszenia GitHub"

Rozwiązywanie problemów

Częste problemy

Serwer się nie uruchamia:

• Sprawdź wersję Node.js
• Zweryfikuj składnię JSON
• Sprawdź uprawnienia plików

Błędy uwierzytelniania:

• Zweryfikuj tokeny API
• Sprawdź zmienne środowiskowe
• Potwierdź dostęp sieciowy

Problemy wydajności:

• Ogranicz aktywne serwery
• Zwiększ pamięć Node
• Sprawdź zasoby systemowe

Tryb debugowania

Uruchom Cursor z logowaniem debug:

# Sprawdź plik konfiguracji MCP pod kątem błędów składni
# Wyświetl logi konsoli w Developer Tools (Pomoc > Toggle Developer Tools)

Wyświetl logi:

1. Otwórz panel Output: Ctrl + Shift + U
2. Wybierz “MCP Logs” z menu rozwijanego
3. Szukaj komunikatów błędów

Reset MCP

Jeśli nic nie pomaga:

# Kopia zapasowa konfiguracji
cp ~/.cursor/mcp.json ~/.cursor/mcp.json.backup

# Wyczyść cache MCP
rm -rf ~/.cursor/mcp-cache

# Restart Cursor

Najlepsze praktyki bezpieczeństwa

Używaj zmiennych środowiskowych

Nigdy nie koduj poświadczeń na stałe w mcp.json

"env": {
  "API_KEY": "${API_KEY}"
}

Ogranicz uprawnienia

Ogranicz dostęp do systemu plików i używaj trybu tylko do odczytu gdzie możliwe

Audytuj serwery

Przejrzyj kod serwera MCP przed instalacją

Rotuj poświadczenia

Regularnie aktualizuj klucze API i tokeny

Zaawansowane techniki MCP

Tworzenie niestandardowych komend

# Utwórz skróty dla częstych operacji MCP
# Uwaga: Używaj UI Cursor aby sprawdzać status serwera MCP i przeładowywać
# Widok > Output > Wybierz "MCP" z menu rozwijanego

MCP specyficzne dla projektu

Utwórz .cursor/mcp.json w katalogu głównym projektu:

{
  "mcpServers": {
    "project-db": {
      "command": "docker",
      "args": ["exec", "project-db", "psql"]
    }
  }
}

Warunkowe ładowanie MCP

Używaj wykrywania środowiska:

{
  "mcpServers": {
    "dev-db": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "${DEV_DATABASE_URL}"
      },
      "condition": "${NODE_ENV} === 'development'"
    }
  }
}

Co dalej z MCP

Wskazówka

Teraz masz supermoce! Context7 utrzymuje twój kod aktualny, Puppeteer automatyzuje testowanie, a dostęp do bazy danych usprawnia rozwój.

Zalecane następne kroki

1. Eksploruj więcej serwerów: Przeglądaj katalog MCP
2. Buduj niestandardowe serwery: Twórz serwery MCP dla swoich konkretnych potrzeb
3. Dziel się konfiguracjami: Sprawdzaj .cursor/mcp.json do Git do użytku zespołowego

Następne kroki

Kontynuuj do pierwszej funkcji

Teraz zbudujmy twoją pierwszą funkcję wspomaganą przez AI używając wszystkiego co skonfigurowaliśmy.

Pierwsza funkcja →

Czas: 15 minut

Wskazówka

Wskazówka pro: Zacznij od 2-3 serwerów MCP i dodawaj więcej według potrzeb. Zbyt wiele aktywnych serwerów może spowolnić Cursor i zwiększyć złożoność.