Cursor MCP Servers 2026: What They Are and How to Use Them
March 2026 -- Cursorin AI-agentti on tehokas itsessään. Mutta ilman MCP-palvelimia se on jumissa editorissasi ilman keinoa päästä käsiksi tietokantaasi, GitHub-repoihisi, dokumentaatioosi tai kymmeniin muihin työkaluihin, joita käytät päivittäin.
MCP-palvelimet korjaavat tämän. Ne ovat silta Cursorin AI:n ja ulkoisen maailman välillä -- ja kun olet tehnyt niiden asennuksen, ero agentin suorituskyvyssä on kuin yö ja päivä.
Tämä opas kattaa kaiken: mikä MCP on, miten se toimii Cursorin sisällä, miten asennat ensimmäisen palvelimesi, kymmenen hyödyllisintä palvelinta kehittäjille ja miten vianmääritys tehdään ongelmatilanteissa.
Mikä on MCP (Model Context Protocol)?
MCP tarkoittaa Model Context Protocolia. Se on Anthropicin luoma avoin standardi, joka määrittelee, kuinka AI-sovellukset yhdistyvät ulkoisiin työkaluihin ja tietolähteisiin yhden, johdonmukaisen käyttöliittymän kautta.
Ajattele sitä kuin USB-liitäntänä AI-työkaluille. Ennen USB-liitäntää jokainen oheislaite tarvitsi oman mallisuojatun kaapelinsa. Ennen MCP:tä jokainen AI-integraatio vaati mukautettua koodia -- erilaisen API-kääreen GitHubille, toisen tietokannallesi, kolmannen Slackille. MCP korvaa kaiken tämän yhdellä protokollalla.
MCP-palvelin on kevyt ohjelma, joka tuo tietyn työkalun tai tietolähteen saataville MCP-protokollan kautta. Filesystem MCP-palvelin antaa AI:n lukea ja kirjoittaa tiedostoja. GitHub MCP-palvelin antaa AI:n hallita repositorioita ja pull requests -pyyntöjä. Tietokannan MCP-palvelin antaa AI:n ajaa kyselyitä. Jokainen palvelin on pieni, keskittynyt ohjelma, joka tekee yhden asian hyvin.
Keskeinen oivallus: MCP-palvelimet eivät ole Cursor-kohtaisia. Sama MCP-palvelin, joka toimii Cursorissa, toimii myös Claude Code-, Windsurf- ja missä tahansa muussa työkalussa, joka tukee protokollaa. Konfiguroit sen kerran, ja se on siirrettävissä koko AI-työkalupakissasi.
Miksi MCP on tärkeä kehittäjille
Ilman MCP:tä työnkulkusi näyttää tältä:
- Pyydät Cursorin agenttia auttamaan tietokantakyselyssä.
- Agentti sanoo, ettei se pääse käsiksi tietokantaasi.
- Kopioit skeeman manuaalisesti, liität sen chattiin, ajat kyselyn itse ja liität tulokset takaisin.
- Agentti analysoi liittämäsi tulokset.
MCP:n avulla sama työnkulku muuttuu tällaiseksi:
- Pyydät Cursorin agenttia tarkistamaan, miksi käyttäjien rekisteröitymiset vähenivät viime viikolla.
- Agentti yhdistää tietokantaasi MCP-palvelimen kautta, ajaa kyselyn, analysoi tulokset ja antaa sinulle vastauksen.
Siinä on ero. MCP poistaa kopioi-liitä-pullonkaulan AI-agenttisi ja sen tarvitsemien työkalujen väliltä. Agentti lakkaa olemasta vain tekstiä käsittelevä avustaja ja muuttuu toimijaksi, joka voi todella olla vuorovaikutuksessa infrastruktuurisi kanssa.
March 2026 mennessä MCP-ekosysteemi on kasvanut yli 5,000 yhteisön rakentamaan palvelimeen. Mitä tahansa työkalua tai palvelua käytätkin, sille on todennäköisesti jo olemassa MCP-palvelin.
Kuinka MCP toimii Cursorissa
Arkkitehtuurissa on kolme kerrosta:
Cursor Agent (AI)
|
v
MCP Client (built into Cursor)
|
v
MCP Server (external process)
|
v
External Tool (GitHub, database, filesystem, etc.)
Kun konfiguroit MCP-palvelimen Cursorissa, tässä on mitä taustalla tapahtuu:
- Cursor käynnistää MCP-palvelimen lapsiprosessina (stdio-siirtoa varten) tai yhdistää siihen HTTP:n kautta (etäpalvelimet).
- Palvelin rekisteröi työkalunsa -- se kertoo Cursorille, mitä ominaisuuksia se tarjoaa (esim. "Voin lukea tiedostoja", "Voin hakea GitHub-repoista", "Voin ajaa SQL-kyselyitä").
- Cursor-agentti näkee nämä työkalut käytettävissä olevassa työkalupakissaan. Kun agentti päättelee, että työkalu on olennainen pyyntösi kannalta, se kutsuu sitä automaattisesti.
- Palvelin suorittaa toiminnon ulkoista työkalua vasten ja palauttaa tuloksen agentille.
Cursor tukee kahta pääasiallista siirtotyyppiä:
- stdio -- Palvelin pyörii paikallisesti koneellasi. Cursor kommunikoi sen kanssa standardin sisääntulon/ulostulon kautta. Tämä on yleisin tapa yksittäisille kehittäjille.
- Streamable HTTP -- Palvelin pyörii itsenäisenä prosessina (paikallisesti tai etänä) ja kommunikoi HTTP-yhteyden yli. Parempi tiimiympäristöihin ja etäpalvelimille.
Yksi tärkeä rajoitus: Cursor tukee tällä hetkellä enintään 40 työkalua kaikissa MCP-palvelimissasi yhteensä. Useimmat kokoonpanot toimivat hyvin 3-5 palvelimella.
Ensimmäisen MCP-palvelimen asennus
Esivaatimukset: Node.js v18 tai uudempi ja Cursor v0.42 tai uudempi.
Tapa 1: Cursor-asetusten kautta (Suositeltu)
- Avaa Cursor-asetukset painamalla
Cmd + ,(Mac) taiCtrl + ,(Windows/Linux). - Siirry kohtaan Tools & MCP sivupalkissa.
- Klikkaa + Add New MCP Server.
- Täytä kentät:
- Name: Palvelimen nimi (esim. "Filesystem")
- Transport Type: Valitse
stdio - Command: Komento, jolla palvelin käynnistetään
Esimerkiksi filesystem-palvelimen lisäämiseksi:
- Name:
filesystem - Type:
stdio - Command:
npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/directory
Tapa 2: Projektikohtainen konfiguraatiotiedosto
Luo .cursor/mcp.json -tiedosto projektisi juureen:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/you/projects/my-app"
]
}
}
}
Tämä konfiguraatio koskee vain tätä projektia. Tiimin jäsenet, jotka kloonaavat repon, saavat saman MCP-asennuksen automaattisesti.
Tapa 3: Globaali konfiguraatiotiedosto
Luo ~/.cursor/mcp.json palvelimille, jotka haluat olevan käytettävissä kaikissa projekteissa:
{
"mcpServers": {
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_your_token_here"
}
}
}
}
Palvelimen lisäämisen jälkeen mene takaisin kohtaan Cursor Settings > Tools & MCP. Sinun pitäisi nähdä palvelimesi listattuna vihreällä merkkivalolla, joka osoittaa sen olevan yhdistetty. Sen tarjoamat työkalut ilmestyvät kohtaan "Available Tools."
10 parasta MCP-palvelinta Cursorille
Nämä ovat hyödyllisimmät MCP-palvelimet päivittäiseen kehitystyöhön, perustuen todelliseen käyttödataan ja yhteisön suosioon.
1. Filesystem
Lue, kirjoita, etsi ja hallitse tiedostoja paikallisella koneellasi. Antaa agentille suoran pääsyn projektitiedostoihin Cursorin omien ominaisuuksien lisäksi.
{
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/directory"]
}
}
2. GitHub
Hallitse repositorioita, issues-ilmoituksia, pull requests -pyyntöjä ja koodihakua suoraan agentin kautta. Virallinen GitHub MCP-palvelin tukee kaikkia keskeisiä GitHub-toimintoja.
{
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
}
}
}
3. PostgreSQL / SQLite (Database)
Anna agentin tehdä kyselyitä tietokantaasi, tarkastaa skeemoja ja analysoida dataa poistumatta Cursorista.
{
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
}
}
PostgreSQL-palvelimelle:
{
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost:5432/mydb"
}
}
}
4. Brave Search (Web Search)
Anna agentille kyky hakea tietoa elävästä verkosta. Käyttää Braven itsenäistä hakuindeksiä ilman seurantaa.
{
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "your_brave_api_key"
}
}
}
5. Playwright (Browser Automation)
Agentti voi navigoida verkkosivustoilla, täyttää lomakkeita, ottaa kuvakaappauksia ja kerätä sisältöä käyttämällä oikeaa selainta.
{
"playwright": {
"command": "npx",
"args": ["-y", "@executeautomation/playwright-mcp-server"]
}
}
6. Slack
Lue kanavia, lähetä viestejä, hae keskusteluhistoriaa. Hyödyllinen agenteille, joiden täytyy hakea kontekstia tiimin keskusteluista.
{
"slack": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-slack"],
"env": {
"SLACK_BOT_TOKEN": "xoxb-your-token",
"SLACK_TEAM_ID": "T0123456789"
}
}
}
7. Memory (Persistent Knowledge)
Antaa agentille pysyvän muistin istuntojen välillä. Se voi tallentaa ja palauttaa mieleen faktoja, päätöksiä ja kontekstia, jotka muuten katoaisivat, kun suljet chatin.
{
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
8. Context7 (Documentation Search)
Syöttää versio-kohtaista dokumentaatiota suoraan agentin kontekstiin. Erityisen hyödyllinen työskenneltäessä frameworkien kanssa, joissa AI:n koulutusdata voi olla vanhentunutta.
{
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
9. Docker
Hallitse kontteja, imageja ja compose-pinoja. Agentti voi käynnistää palveluita, tarkistaa lokeja ja tehdä vianmääritystä konttiongelmissa.
{
"docker": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-docker"]
}
}
10. Sequential Thinking
Ei työkaluliitin, vaan päättelykyvyn parantaja. Se rakentaa agentin ajatusprosessin monimutkaisiin, monivaiheisiin ongelmiin jakamalla ne peräkkäisiksi päättelyvaiheiksi.
{
"sequential-thinking": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
}
}
Edistynyt konfigurointi
Ympäristömuuttujat
MCP-palvelimet tarvitsevat usein API-avaimia ja tunnuksia. Välitä ne konfiguraatiosi env-kentän kautta:
{
"mcpServers": {
"my-server": {
"command": "npx",
"args": ["-y", "my-mcp-server"],
"env": {
"API_KEY": "sk-xxxxxxxxxxxx",
"API_URL": "https://api.example.com"
}
}
}
}
Älä koskaan tallenna API-avaimia versionhallintaan. Tiimin kanssa jaetuissa projektikohtaisissa konfiguraatioissa käytä paikkamerkkejä ja dokumentoi tarvittavat ympäristömuuttujat erikseen.
Mukautetun MCP-palvelimen rakentaminen
Jos mikään olemassa oleva palvelin ei sovi tarpeisiisi, voit rakentaa sellaisen. MCP SDK on saatavilla TypeScriptille, Pythonille ja useille muille kielille:
npm install @modelcontextprotocol/sdk
Minimaalinen mukautettu palvelin TypeScriptillä:
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
const server = new McpServer({ name: "my-server", version: "1.0.0" });
server.tool("hello", "Says hello to a user", { name: { type: "string" } },
async ({ name }) => ({
content: [{ type: "text", text: `Hello, ${name}!` }]
})
);
const transport = new StdioServerTransport();
await server.connect(transport);
Projektikohtainen vs. globaali konfiguraatio
Käytä projektikohtaista (.cursor/mcp.json) konfiguraatiota:
- Projektikohtaisiin tietokantayhteyksiin
- Sisäisiin API-palvelimiin
- Projektikohtaisiin työkaluihin, joita tiimiläiset tarvitsevat
Käytä globaalia (~/.cursor/mcp.json) konfiguraatiota:
- GitHub, GitLab tai muihin koodinhallinnan integraatioihin
- Verkkohakuun
- Yleiskäyttöisiin työkaluihin kuten memory tai sequential thinking
Kun sama palvelimen nimi esiintyy molemmissa tiedostoissa, projektikohtainen konfiguraatio on etusijalla.
MCP Cursorissa vs. Claude Code vs. Windsurf
MCP on avoin protokolla, ja kaikki kolme suurta AI-koodaustyökalua tukevat sitä nyt. Mutta toteutukset eroavat toisistaan merkittävillä tavoilla.
| Ominaisuus | Cursor | Claude Code | Windsurf |
|---|---|---|---|
| MCP-tuki | Kyllä (v0.42+) | Kyllä (natiivi) | Kyllä |
| Siirtotyypit | stdio, SSE, Streamable HTTP | stdio, Streamable HTTP | stdio, SSE |
| Konfiguraatio | .cursor/mcp.json | ~/.claude/mcp.json tai projektitaso | .windsurf/mcp.json |
| Työkalurajoitus | Enintään 40 työkalua | Ei tiukkaa rajaa | Vaihtelee |
| Yhden klikkauksen asennus | Kyllä (valikoidut palvelimet) | Rajoitettu | Kyllä |
| OAuth-tuki | Kyllä | Ei (manuaaliset tokenit) | Kyllä |
| Yritystason hallinta | Perus | N/A (CLI-työkalu) | Järjestelmänvalvojatason hallinta |
| IDE-lukittuminen | Vain Cursor (VS Code -haarukka) | Toimii missä tahansa terminaalissa / VS Code -laajennuksessa | 40+ IDE-liitännäistä |
Cursor on helpoin asentaa yhden klikkauksen palvelinasennuksen ja asetusliittymän ansiosta. Sen rajoitus on 40 työkalun katto ja lukittuminen Cursor-editoriin.
Claude Code toimii terminaalissa ja VS Code -laajennuksena. Siinä on syvin MCP-integraatio, koska Anthropic loi sekä Clauden että MCP:n. Ei työkalurajoitusta, mutta asennus on manuaalisempaa.
Windsurf tarjoaa laajimman IDE-yhteensopivuuden ja vahvimmat yritystason hallintatyökalut. Jos tiimisi tarvitsee järjestelmänvalvojan hallitsemia MCP-konfiguraatioita, Windsurf on vahvoilla.
Hyvä uutinen: koska MCP on avoin protokolla, itse palvelimet ovat keskenään vaihdettavissa. Palvelin, jonka konfiguroit Cursorille, toimii Claude Codessa ja Windsurfissa pelkällä konfiguraatiotiedoston muutoksella.
Yleisten ongelmien vianmääritys
Palvelin näyttää tilaksi "Not Connected" asetuksissa
- Tarkista, että Node.js v18+ on asennettu:
node --version - Varmista, että npx-komento toimii Cursorin ulkopuolella: aja komento suoraan terminaalissasi
- Katso Cursorin kehittäjäkonsolista (
Help > Toggle Developer Tools) virheilmoituksia - Käynnistä Cursor uudelleen palvelinkonfiguraatioiden lisäämisen tai muuttamisen jälkeen
Työkalut eivät näy agentin käytettävissä olevissa työkaluissa
- Varmista, että palvelimen vihreä tilailmaisin näkyy kohdassa Settings > Tools & MCP
- Tarkista, ettet ole ylittänyt 40 työkalun rajaa kaikissa palvelimissa yhteensä
- Kokeile poistaa ja lisätä palvelin uudelleen
Palvelin kaatuu tai aikakatkaistaan
- Jotkut palvelimet tarvitsevat tiettyjä ympäristömuuttujia. Tarkista palvelimen README vaadittavista asetuksista
- Lisää muistin varausta, jos palvelin käsittelee suuria tietomääriä
- stdio-palvelimien kohdalla varmista, ettei mikään muu prosessi kilpaile samasta stdin/stdout-yhteydestä
Todennusvirheet
- Tarkista API-avaimet ja tunnukset
env-konfiguraatiosta - GitHubin kohdalla varmista, että personal access tokenilla on vaaditut oikeudet (yleensä
repo,read:org) - OAuth-pohjaisten palvelimien kohdalla kokeile uudelleentunnistautumista Cursorin asetusliittymän kautta
Konfiguraatio ei lataudu
- Projektikohtaisissa konfiguraatioissa varmista, että tiedosto on kohdassa
.cursor/mcp.json(ei.cursor/mcp/config.jsontai muita variaatioita) - Validoi JSON-syntaksi -- yksikin väärässä paikassa oleva pilkku rikkoy koko tiedoston
- Käynnistä Cursor uudelleen minkä tahansa konfiguraatiomuutoksen jälkeen
Loppupäätelmä
MCP-palvelimet muuttavat Cursorin älykkäästä tekstieditorista AI-pohjaiseksi kehitysympäristöksi, joka voi todella olla vuorovaikutuksessa työkalujesi ja infrastruktuurisi kanssa. Asennus vie viisi minuuttia ensimmäisen palvelimen kohdalla, ja tuottavuuden kasvu on välitön.
Aloita kahdella tai kolmella palvelimella, jotka sopivat päivittäiseen työnkulkuusi -- filesystem, GitHub ja tietokantaliitin kattavat useimpien kehittäjien tarpeet. Lisää uusia tarpeen mukaan. Ja muista, että jokainen MCP-palvelin, jonka konfiguroit Cursorissa, on siirrettävä: jos vaihdat huomenna Claude Codeen tai Windsurfiin, palvelimesi seuraavat mukanasi.
MCP-ekosysteemi kasvaa nopeasti. Yli 5,000 saatavilla olevan palvelimen ja jokaisen suuren AI-koodaustyökalun tuen myötä MCP ei ole enää kokeilu. Se on standardi tapa, jolla AI-työkalut yhdistyvät ulkoiseen maailmaan -- ja Cursor on yksi parhaista paikoista aloittaa sen käyttö.