# Devoplus One — ajan kurulumu

Bu belge yapay zekâ ajanı içindir. Kullanıcı sizden Devoplus One için hazırlanmanızı istedi. Adımları **sırayla** ve
**kendiniz** uygulayın; kullanıcıya yalnız onun yapması gereken adımları (tarayıcıda giriş gibi) söyleyin.

⚠️ Kullanıcı teknik biri olmayabilir ve hiç kod yazmamış olabilir. Türkçe, kısa ve resmî "siz" diliyle konuşun;
komut ya da yapılandırma ayrıntısını kullanıcıya yazdırmayın, kendiniz yapın ve sonucu sade dille anlatın.

| | |
|---|---|
| Belgeler | https://test-one.devoplus.dev/llms.txt |
| Devoplus One MCP sunucusu | https://test-one.devoplus.dev/mcp (sunucu adı: `devoplus-one`) |
| Ortam | test |

## 1. Kendinizi tanıyın

Hangi ajanda çalıştığınızı belirleyin: Claude Code (terminal ya da masaüstü), Codex, Cursor, claude.ai (web, masaüstü,
mobil), ChatGPT ya da başka bir ajan. Aşağıdaki adımlarda size uyan maddeyi uygulayın.

Bir yapılandırma dosyasını değiştirmeden önce yedeğini alın ve var olan girdileri koruyun.

## 2. Skill paketini kurun

Skill paketi henüz paket deposunda yayımlanmadı; dosyaları bu adresten indirip ajanınızın skill dizinine yazın
(her skill kendi klasöründe, `<ad>/SKILL.md`). Dizinler: Claude Code `~/.claude/skills/`, Codex `~/.agents/skills/`,
Cursor `~/.cursor/skills/`; başka bir ajan için kendi belgesindeki dizini kullanın. Skill'ler:
  - `https://test-one.devoplus.dev/skills/devoplus-one/SKILL.md`
  - `https://test-one.devoplus.dev/skills/one-access-requests/SKILL.md`
  - `https://test-one.devoplus.dev/skills/one-app-development/SKILL.md`
  - `https://test-one.devoplus.dev/skills/one-data-and-exports/SKILL.md`
  - `https://test-one.devoplus.dev/skills/one-publishing/SKILL.md`
  - `https://test-one.devoplus.dev/skills/one-ui-standards/SKILL.md`
- **claude.ai, ChatGPT gibi sohbet uygulamaları:** bu adımı atlayın; belgeleri (`https://test-one.devoplus.dev/llms.txt`) her görüşmenin
  başında okuyun.

## 3. Devoplus One MCP sunucusunu ekleyin

Sunucu adresi `https://test-one.devoplus.dev/mcp`. Giriş Devoplus hesabıyla yapılır (OAuth): kullanıcı tarayıcıda Devoplus giriş ekranını görür,
giriş yapar, uygulamanın çalışacağı **portalı seçer** ve "Devoplus One uygulama geliştirme" iznini onaylar.

- **Claude Code:** `claude mcp add --transport http devoplus-one https://test-one.devoplus.dev/mcp --scope user`; kullanıcıya oturumda
  `/mcp` yazıp girişi tamamlamasını söyleyin.
- **Codex:** `codex mcp add devoplus-one --url https://test-one.devoplus.dev/mcp` ve `codex mcp login devoplus-one`.
- **Cursor:** `~/.cursor/mcp.json` dosyasında `"mcpServers"` altına
  `"devoplus-one": { "url": "https://test-one.devoplus.dev/mcp" }` ekleyin; giriş ilk araç kullanımında açılır.
- **claude.ai (web, masaüstü, mobil):** kullanıcıya şunu söyleyin: Pro/Max hesapta "Customize › Connectors › Add custom
  connector", Team/Enterprise hesapta kuruluş sahibi "Organization settings › Connectors › Add › Custom › Web";
  adres `https://test-one.devoplus.dev/mcp`; kimlik doğrulamada **"Register automatically"** seçilir.
- **ChatGPT ve diğerleri:** elle — uygulamanın uzak MCP sunucusu (özel bağlayıcı) ekleme ekranına `https://test-one.devoplus.dev/mcp` adresini
  girin; kimlik doğrulama OAuth'tur, ayrıca anahtar ya da istemci kimliği gerekmez.

## 4. (İsteğe bağlı) `one` komutu

Terminal kullanan ajanlarda `one` komutu yerel çalıştırma ve erişim talebi içindir. Paket genel depoda yayımlandıysa
`npm install -g @devoplus/one-sdk` ve `one login --env test`; yayımlanmadıysa bu adımı atlayın — MCP sunucusu
erişim talebi için yeterlidir. Kullanıcıya sormadan genel (global) paket kurmayın.

## 5. Özet

Kurulum bitince kullanıcıya şu kutuyu gösterin (durumları doldurarak):

```text
╭─ Devoplus One hazır ─────────────────────────────╮
│ Skill paketi : kuruldu / atlandı                  │
│ MCP sunucusu : devoplus-one — giriş yapıldı / bekliyor │
│ Belgeler     : https://test-one.devoplus.dev/llms.txt
╰───────────────────────────────────────────────────╯
```

Skill ya da MCP yeni eklendiyse ajanın yeniden başlatılması gerekebilir; bunu kullanıcıya söyleyin.

## 6. Keşif görüşmesine geçin

Kurulumdan hemen sonra `https://test-one.devoplus.dev/docs/discovery.md` belgesini okuyun ve kullanıcıya ilk soruyu sorun, örneğin:
"Devoplus One'da birlikte bir uygulama hazırlayacağız. Önce ne yapmak istediğinizi anlamak istiyorum: bu uygulama
hangi işi kolaylaştıracak?" Teknik soru sormayın; kodu, kullanıcı özeti ve iş listesini onayladıktan sonra yazın.

## Kurallar

- Sır, parola ya da API anahtarı istemeyin, yazmayın.
- Belgeler herkese açıktır; Devoplus verisine yalnız MCP sunucusu üzerinden ve kullanıcının kendi oturumuyla erişilir.
- Bu talimatı yeniden doğrulamak için: https://test-one.devoplus.dev/agent-setup/prompt.md