Tool Examples

Tool Use Examples

Anthropic araştırmasına göre, tool examples %72 → %90 accuracy artışı sağlar.

GitHub MCP

PR Oluşturma

{
  "tool": "mcp__github__create_pull_request",
  "input": {
    "owner": "company",
    "repo": "backend-api",
    "title": "feat(auth): Add JWT refresh token support",
    "body": "## Summary\n- Implements refresh token rotation\n- Adds token expiry handling\n\n## Test Plan\n- [ ] Unit tests pass\n- [ ] Integration tests pass",
    "head": "feature/jwt-refresh",
    "base": "develop"
  }
}

Issue Oluşturma

{
  "tool": "mcp__github__create_issue",
  "input": {
    "owner": "company",
    "repo": "backend-api",
    "title": "[BUG] Login fails with expired session",
    "body": "## Description\nUsers see 500 error when session expires\n\n## Steps to Reproduce\n1. Login\n2. Wait 30 min\n3. Try any action\n\n## Expected\nRedirect to login\n\n## Actual\n500 error",
    "labels": ["bug", "auth", "priority:high"]
  }
}

PostgreSQL MCP

Query Çalıştırma

{
  "tool": "mcp__postgres__query",
  "input": {
    "sql": "SELECT id, email, created_at FROM users WHERE status = $1 ORDER BY created_at DESC LIMIT $2",
    "params": ["active", 10]
  }
}

Schema Bilgisi

{
  "tool": "mcp__postgres__get_schema",
  "input": {
    "table_name": "users"
  }
}

⚠️ DİKKAT:

• Parametreli query kullan (SQL injection önleme)
• SELECT * yerine gerekli kolonları belirt
• LIMIT kullan (büyük result set'ler için)

Memory MCP

Bilgi Kaydetme

{
  "tool": "mcp__memory__store",
  "input": {
    "key": "project:auth:decisions",
    "value": {
      "decision": "JWT with refresh tokens",
      "date": "2024-01-15",
      "reason": "Scalability and stateless auth",
      "alternatives_considered": ["session-based", "OAuth only"]
    }
  }
}

Bilgi Okuma

{
  "tool": "mcp__memory__retrieve",
  "input": {
    "key": "project:auth:decisions"
  }
}

Key Naming Convention

project:<module>:<type>
  project:auth:decisions
  project:auth:config
  project:users:schema
  
session:<id>:<type>
  session:abc123:state
  session:abc123:progress

Filesystem MCP

Dosya Okuma

{
  "tool": "mcp__filesystem__read_file",
  "input": {
    "path": "/src/services/user-service.ts"
  }
}

Dosya Listeleme

{
  "tool": "mcp__filesystem__list_directory",
  "input": {
    "path": "/src/services",
    "recursive": false
  }
}

Slack MCP

Mesaj Gönderme

{
  "tool": "mcp__slack__post_message",
  "input": {
    "channel": "#dev-notifications",
    "text": "🚀 Deployment completed: v1.2.3 is now live on production",
    "blocks": [
      {
        "type": "section",
        "text": {
          "type": "mrkdwn",
          "text": "*Deployment Complete*\nVersion: `v1.2.3`\nEnvironment: Production"
        }
      }
    ]
  }
}

Sentry MCP

Error Raporlama

{
  "tool": "mcp__sentry__capture_exception",
  "input": {
    "error": "PaymentProcessingError",
    "message": "Payment gateway timeout after 30s",
    "extra": {
      "user_id": "usr_123",
      "amount": 99.99,
      "gateway": "stripe"
    },
    "tags": {
      "module": "payments",
      "severity": "high"
    }
  }
}

Redis MCP

Cache Set

{
  "tool": "mcp__redis__set",
  "input": {
    "key": "user:123:profile",
    "value": "{\"name\":\"John\",\"email\":\"john@example.com\"}",
    "ttl": 3600
  }
}

Cache Get

{
  "tool": "mcp__redis__get",
  "input": {
    "key": "user:123:profile"
  }
}

Key Patterns

<entity>:<id>:<type>
  user:123:profile
  user:123:sessions
  
cache:<resource>:<identifier>
  cache:api:users:list
  cache:api:products:featured

Puppeteer MCP

Sayfa Açma ve Navigate

{
  "tool": "mcp__puppeteer__navigate",
  "input": {
    "url": "http://localhost:3000/login"
  }
}

Screenshot Alma

{
  "tool": "mcp__puppeteer__screenshot",
  "input": {
    "name": "login-page",
    "fullPage": false
  }
}

Element'e Tıklama

{
  "tool": "mcp__puppeteer__click",
  "input": {
    "selector": "button[type='submit']"
  }
}

Form Doldurma

{
  "tool": "mcp__puppeteer__fill",
  "input": {
    "selector": "input[name='email']",
    "value": "test@example.com"
  }
}

Element Bekleme

{
  "tool": "mcp__puppeteer__waitForSelector",
  "input": {
    "selector": ".success-message",
    "timeout": 5000
  }
}

JavaScript Çalıştırma

{
  "tool": "mcp__puppeteer__evaluate",
  "input": {
    "script": "document.querySelector('.user-name')?.textContent"
  }
}

E2E Test Akışı Örneği

1. Navigate → Login sayfası
2. Fill → Email input
3. Fill → Password input
4. Click → Submit button
5. WaitForSelector → Dashboard element
6. Screenshot → Sonuç doğrulama

⚠️ DİKKAT:

• waitForSelector ile element'in yüklenmesini bekle
• Timeout'ları makul tut (5-10 saniye)
• Screenshot ile kritik adımları belgele
• Test sonrası tarayıcıyı kapat

Best Practices

✅ YAP

• Parametreli query kullan
• Key naming convention uygula
• TTL ayarla (cache için)
• Error handling ekle
• E2E testlerde screenshot al
• Selector'larda data-testid kullan

❌ YAPMA

• Hardcoded değerler kullanma
• Büyük data'yı cache'leme (>1MB)
• Sensitive data'yı log'lama
• Rate limit'i aşma
• Sleep/delay yerine waitForSelector kullan