---
title: Yerel MCP | RunAPI
description: RunAPI MCP Sunucusunu Claude Code, Cursor, VS Code, Windsurf veya başka
  bir stdio istemcisiyle yerel olarak çalıştırın.
url: https://runapi.ai/tr/docs/resources/mcp/local.md
canonical: https://runapi.ai/tr/docs/resources/mcp/local
locale: tr
---

> HTML sürümü: https://runapi.ai/tr/docs/resources/mcp/local
> Ajanlar için site dizini: https://runapi.ai/llms.txt

# Yerel MCP

Yerel MCP, MCP istemcinizin makinenizde RunAPI MCP Sunucusunu başlatmasını sağlar. İstemci Uzak MCP'yi desteklemediğinde veya açıkça yerel bir sürece ihtiyaç duyduğunuzda kullanın.

## Başlamadan önce

Node.js'yi yükleyin ve `npx`'in kullanılabilir olduğunu doğrulayın. MCP istemcinizin yerel stdio sunucularını desteklemesi gerekir.

Aşağıdaki her istemci aynı komutu başlatır:

```shell
npx -y @runapi.ai/mcp
```

Katalog araçlarına oturum açmadan bağlanabilir ve kullanabilirsiniz.

## Claude Code

Çalıştırın:

```shell
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
```

RunAPI'yi projelerinizde kullanılabilir kılmak için `-s user` seçeneğini kullanın. Zaten çalışıyorsa Claude Code'u yeniden başlatın, ardından RunAPI'nin bir MCP sunucusu olarak listelendiğini doğrulayın.

## İmleç

Sunucuyu `.cursor/mcp.json` veya kullanıcı MCP yapılandırmanızdaki `mcpServers` altına ekleyin:

```json
{
  "mcpServers": {
    "runapi": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/mcp"]
    }
  }
}
```

Cursor kenar çubuğunda **Customize** seçeneğini açın, RunAPI'yi bulun ve etkinleştirin. İşlem başlamazsa **Output** panelini açın ve **MCP Logs** seçeneğini belirleyin.

## VS Code

1.  Komut Paleti'ni açın ve **MCP: Add Server** komutunu çalıştırın.
2.  **Command (stdio)** seçeneğini belirleyin ve `npx -y @runapi.ai/mcp` girin.
3.  Sunucuyu **RunAPI** olarak adlandırın, yapılandırma kapsamını seçin ve sunucuyu başlatın.
4.  İstendiğinde sunucuya güvenin. Hata durumunda **MCP: List Servers** komutunu çalıştırın, RunAPI'yi seçin ve **Show Output** seçeneğini belirleyin.

VS Code, manuel yapılandırmayı üst düzey `servers` anahtarı altında saklar
ve `type: "stdio"` kullanır.

## Windsurf

Bu adımlar Cascade aracısı için geçerlidir. Devin Local, Devin CLI yapılandırmasını kullanır.

1.  **Devin Settings > Cascade > MCP Servers** bölümünü açın.
2.  `~/.codeium/windsurf/mcp_config.json` adresindeki ham MCP yapılandırmasını açın.
3.  Yukarıdaki Cursor örneğinde gösterilen `npx` komutu ve argümanlarıyla RunAPI'yi ekleyin.
4.  Dosyayı kaydedin, MCP sunucularını yenileyin ve RunAPI'yi etkinleştirin.

## Diğer MCP istemcileri

**RunAPI** adında yerel bir stdio sunucusu ekleyin. Komutunu `npx`, argümanlarını ise `-y` ve `@runapi.ai/mcp` olarak ayarlayın. Yapılandırmayı kaydettikten sonra istemciyi yeniden başlatın veya yenileyin.

## Bağlantıyı doğrulayın

İstemcinize sorun:

> Hangi RunAPI görüntü modelleri kullanılabilir?

İstemci `list_models` çağrısı yapmalı ve kullanılabilir görüntü modellerini döndürmelidir. Bu genel keşif aracı kimlik doğrulaması gerektirmez.

## Gerektiğinde oturum açın

Oturum açmadan keşif araçlarını kullanmaya devam edin. RunAPI'den ilk kez bir görev oluşturmasını, bir görevi almasını veya bir bakiyeyi kontrol etmesini istediğinizde istemcinin `login` aracını çağırmasına izin verin. Bu araç RunAPI'yi tarayıcınızda açar ve kimlik bilgisini paylaşılan yerel yapılandırmaya kaydeder.

Bir terminalden oturum açmayı tercih ediyorsanız [RunAPI CLI](https://runapi.ai/tr/docs/resources/cli.md) aracını yükleyip şunu çalıştırın:

```shell
runapi login
```

Gözetimsiz veya CI istemcileri için [Kimlik Doğrulama
Kılavuzu](https://runapi.ai/tr/docs/guides/authentication.md)'nu takip ederek adanmış bir standart API anahtarı oluşturun, ardından istemcinin ortam veya gizli yapılandırması aracılığıyla `RUNAPI_API_KEY` olarak sağlayın. Ortam anahtarı, Yerel MCP Girişiyle kaydedilen kimlik bilgisine göre öncelik taşır.

## Sorun giderme

* `npx` bulunamıyor: `node --version` ve `npx --version` komutlarının
  çalıştığını doğrulayın, ardından MCP istemcisini güncellenmiş ortamı
  alması için tam olarak yeniden başlatın.
* Yerel sunucu hemen kapanıyor: bir terminalde `npx -y @runapi.ai/mcp`
  komutunu çalıştırın, bildirilen Node.js veya paket hatasını düzeltin,
  ardından istemciyi yeniden başlatın.
* RunAPI araçları görünmüyor: sunucunun etkin olduğunu ve komutun stdio
  kullandığını doğrulayın, ardından yukarıda açıklanan istemci günlüğünü
  kontrol edin.
* Kimlik doğrulaması gerektiren bir araç başarısız oluyor: istemciden
  `login` aracını çağırmasını isteyin. `RUNAPI_API_KEY` ayarlıysa, Yerel
  MCP Girişini tekrar denemeden önce güncelleyin veya kaldırın.

Yerel bir Node.js işlemi olmadan bağlantı mı tercih ediyorsunuz? [Barındırılan MCP'yi kurun](https://runapi.ai/tr/docs/resources/mcp/hosted.md).

---

## RunAPI hakkında daha fazlası

- [Ana sayfa](https://runapi.ai/tr/.md)
- [Model Kataloğu](https://runapi.ai/tr/models.md)
- [Fiyatlandırma](https://runapi.ai/tr/pricing.md)
- [Sağlayıcılar](https://runapi.ai/tr/models)
- [Dokümantasyon](https://runapi.ai/tr/docs/guides)
- [SDK'lar](https://runapi.ai/tr/sdk.md)
- [CLI](https://runapi.ai/tr/cli.md)
- [MCP Sunucusu](https://runapi.ai/tr/mcp.md)
- [Claude Code ve Cursor](https://runapi.ai/tr/claude-code-vs-cursor.md)
- [Cursor API kurulumu](https://runapi.ai/tr/cursor-api-setup.md)
- [RunAPI ve OpenRouter](https://runapi.ai/tr/openrouter-alternative.md)
- [Kurumsal](https://runapi.ai/tr/contact.md)
- [İletişim](https://runapi.ai/tr/contact.md)
- [Şartlar](https://runapi.ai/tr/terms.md)
- [Gizlilik](https://runapi.ai/tr/privacy.md)
- [Ajanlar için site dizini](https://runapi.ai/llms.txt)

İletişim: contact@runapi.ai

## Yapılandırılmış veriler

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/tr/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/tr",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/tricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "tr",
    "@type": "TechArticle",
    "headline": "Yerel MCP",
    "description": "RunAPI MCP Sunucusunu Claude Code, Cursor, VS Code, Windsurf veya başka bir stdio istemcisiyle yerel olarak çalıştırın.",
    "url": "https://runapi.ai/tr/docs/resources/mcp/local",
    "mainEntityOfPage": "https://runapi.ai/tr/docs/resources/mcp/local"
  }
]
```