Eigen MCP Server

Gelişmiş entegrasyonlar için kendi MCP sunucunuzu oluşturabilirsiniz. Bu, işlevsellik üzerinde tam kontrol sağlar ve kendi sistemlerinizle veya desteklenmeyen uygulamalarla entegrasyonlar için idealdir.

Kendi MCP sunucusu ne zaman?

Kendi MCP sunucusu uygun olur:

• Kendi uygulamanıza veya veritabanına entegrasyon yapmak istiyorsunuz
• İstenen entegrasyon Zapier'da mevcut değil
• Belirli güvenlik gereksinimleriniz var
• Araçlarda karmaşık mantığa ihtiyacınız var

Gerekli bilgi

Kendi MCP sunucunuzu inşa etmek için gerekli olanlar:

• Programlama deneyimi (TypeScript/JavaScript veya Python)
• REST API bilgisi
• Sunucular ve barındırma hakkında temel bilgiler

Model Context Protocol

Model Context Protocol (MCP), Anthropic tarafından geliştirilen açık bir standarttır. MCP sunucuları şu araçlarla kullanılabilir:

• AI School
• ChatGPT
• Claude
• Copilot ile Visual Studio Code
• Diğer MCP uyumlu uygulamalar

TypeScript ile hızlı başlangıç

1. Proje kurulumu

mkdir benim-mcp-sunucum
cd benim-mcp-sunucum
npm init -y
npm install @modelcontextprotocol/sdk

2. Sunucu kodu

import { Server } from "@modelcontextprotocol/sdk/server";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio";

const server = new Server({
  name: "benim-sunucum",
  version: "1.0.0",
});

// Araçlarınızı tanımlayın
server.setRequestHandler("tools/list", async () => ({
  tools: [
    {
      name: "benim_aracım",
      description: "Aracın yaptığı şeyin açıklaması",
      inputSchema: {
        type: "object",
        properties: {
          parameter: {
            type: "string",
            description: "Bir parametre",
          },
        },
        required: ["parameter"],
      },
    },
  ],
}));

// Aracı uygulayın
server.setRequestHandler("tools/call", async (request) => {
  if (request.params.name === "benim_aracım") {
    const { parameter } = request.params.arguments;
    // Parametre ile bir şey yap
    return {
      content: [{ type: "text", text: `Sonuç: ${parameter}` }],
    };
  }
});

// Sunucuyu başlat
const transport = new StdioServerTransport();
server.connect(transport);

3. Sunucuyu çalıştırma

npx ts-node server.ts

AI School için HTTP Taşıyıcı

AI School, MCP sunucularını HTTP üzerinden destekler. Sunucunuz MCP mesajlarını kabul eden bir uç nokta sağlamalıdır:

import express from 'express';

const app = express();
app.use(express.json());

app.post('/mcp', async (req, res) => {
  const { method, params } = req.body;

  if (method === 'tools/list') {
    res.json({ tools: [...] });
  } else if (method === 'tools/call') {
    // Aracı çağrısını işle
    res.json({ content: [...] });
  }
});

app.listen(3000);

Barındırma seçenekleri

MCP sunucunuz internet üzerinden erişilebilir olmalıdır:

Seçenek	İçin uygun	Maliyetler
Cloudflare Workers	Hafif iş yükleri	Ücretsiz katman mevcut
Vercel	TypeScript sunucuları	Ücretsiz katman mevcut
Railway	Tüm uygulamalar	Aylık 5$'dan itibaren
AWS Lambda	Ölçeklenebilir çözümler	Kullanıma göre ödeme
Kendi sunucu	Tam kontrol	Değişken

AI School ile Bağlantı

1. Sunucunuzu kamuya açık bir URL'ye dağıtın
2. AI School'daki panoya gidin
3. Koppelingen → Koppeling toevoegen seçeneklerini tıklayın
4. MCP sunucunuzun URL'sini girin
5. Giriş doğrulamasını gerektiği şekilde yapılandırın

Doğrulama

MCP sunucunuza doğrulama ekleyebilirsiniz:

API Anahtar doğrulaması

app.post("/mcp", (req, res, next) => {
  const apiKey = req.headers["x-api-key"];
  if (apiKey !== process.env.API_KEY) {
    return res.status(401).json({ error: "Unauthorized" });
  }
  next();
});

AI School'da doğrulama yöntemi olarak "API Key"i seçin.

OAuth 2.0

Daha karmaşık doğrulama için OAuth 2.0 uygulanabilir. AI School, MCP sunucuları için OAuth 2.1'i destekler.

Örnekler ve kaynaklar

Resmi MCP sunucuları

• MCP Sunucuları GitHub - Resmi örnekler

Dokümantasyon

• MCP Spesifikasyonu - Tam protokol spesifikasyonu
• SDK Dokümantasyonu - TypeScript SDK

Geliştirme için ipuçları

1. Basit başlayın: Bir araçla başlayın ve genişletin
2. Yerelde test edin: Hata ayıklama için MCP Inspector kullanın
3. Günlüklemeler: Sorun gidermeyi kolaylaştırmak için kapsamlı günlükleme ekleyin
4. Hata yönetimi: Net hata mesajları döndürün
5. İstek hız limitleme: Sunucunuzu aşırı yüklenmeden koruyun

Sık karşılaşılan entegrasyonlar

Sistem	Olası araçlar
LVS (Magister, Somtoday)	Notları sorgulama, ders programlarını görüntüleme
CRM sistemleri	Müşteri verilerini sorgulama, notlar ekleme
Veritabanları	Sorgular yürütme, raporlar oluşturma
Kendi uygulamalar	Açmak istediğiniz herhangi bir API

İlgili makaleler

• Zapier MCP Sunucusu - Kod yazmadan basit bağlantılar