# Yapay Zeka Ajanları için FHIR MCP Sunucusu

> Claude Code, Cursor, VS Code veya Claude Desktop'ı MCP aracılığıyla bir HL7 FHIR R4 API'sine bağlayın: kayıtları okumak, yapay zeka için hazır bağlam, yazmak, laboratuvar ithalatı ve sandbox sıfırlama için 20 araç, 30 sentetik hasta üzerinde, ücretsiz.

Source: https://developers.anpheros.com/tr/guides/mcp

**Anpheros FHIR, bir yapay zeka ajanının (Claude, Claude Code, Cursor, VS Code, Claude Desktop) bir HL7 FHIR R4 sağlık verisi API'si ile çalışmasını sağlayan uzaktan bir MCP sunucusudur.** İki yolla bağlanır:

- **Ücretsiz bir sandbox anahtarıyla**, geliştiriciler için: ajanınız hastaları listeler, kayıtlarını FHIR olarak veya köken bilgisiyle yapay zeka için hazır bir bağlam olarak okur, gözlemler yazar, laboratuvar raporlarını içe aktarır ve test verilerini sıfırlar, hepsi gerçekçi geçmişlere sahip 30 sentetik hasta üzerinde.
- **OAuth ile**, bir kişi ve kendi kaydı için: asistan kendini kaydeder, kişi oturum açar ve Anpheros onay ekranında onaylar, ardından asistan seçilen süre boyunca yalnızca o tek kaydı okuyabilir, kişi daha fazlasına izin vermediği sürece salt okunur.

Sunucu adresi: `https://platform.anpheros.com/mcp` (Akışlanabilir HTTP, durum bilgisi olmayan).

## OAuth ile Bağlanma (Claude ve Diğer Asistanlar)

`https://platform.anpheros.com/mcp`'yı özel bir bağlayıcı olarak ekleyin (Claude'da: Ayarlar → Bağlayıcılar → Özel bağlayıcı ekle). Yapılandırılacak başka bir şey yok: asistan yetkilendirme sunucusunu keşfeder, kendini kaydeder ve Anpheros onay ekranını açar. Burada kişi, bunun bir yapay zeka asistanı olduğunu, okuduklarının asistanı çalıştıran şirkete gönderildiğini, neleri okuyabileceğini, ne kadar süreyle ve seçim yaptıktan sonra nereye döneceklerini görür. Erişim, daha fazlası istenip izin verilmediği sürece salt okunur durumdadır ve kişi istediği zaman erişimi iptal edebilir.

Özel beta sırasında, OAuth bağlantıları sandbox kayıtlarını kullanır. Gerçek kayıtlara bağlantılar, gizlilik politikası güncellendikten sonra açılacaktır.

## Bir sandbox anahtarıyla bağlanın (geliştiriciler)

1. [platform.anpheros.com/dashboard](https://platform.anpheros.com/dashboard/) adresinde Google ile oturum açın ve **Bir sandbox anahtarı alın** seçeneğini belirleyin. `sk_test_…` anahtar ve 30 sentetik hasta içeren bir proje elde edersiniz.
2. Anahtarı bir ortam değişkenine koyun, örneğin `ANPHEROS_KEY`, ve sunucuyu aracınıza ekleyin.

**Claude Kodu**

```bash
claude mcp add --transport http anpheros-fhir https://platform.anpheros.com/mcp --header "Authorization: Bearer $ANPHEROS_KEY"
```

**Cursor** (projedeki `~/.cursor/mcp.json` veya `.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "anpheros-fhir": {
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}
```

**VS Code** (`.vscode/mcp.json`)

```json
{
  "servers": {
    "anpheros-fhir": {
      "type": "http",
      "url": "https://platform.anpheros.com/mcp",
      "headers": { "Authorization": "Bearer ${env:ANPHEROS_KEY}" }
    }
  }
}
```

**Claude Desktop** (`claude_desktop_config.json`, `mcp-remote` köprüsü aracılığıyla)

```json
{
  "mcpServers": {
    "anpheros-fhir": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://platform.anpheros.com/mcp", "--header", "Authorization: Bearer ${ANPHEROS_KEY}"],
      "env": { "ANPHEROS_KEY": "sk_test_…" }
    }
  }
}
```

Ardından temsilcinize şunu sorun: *"Sandbox hastalarını listele, diyabetli olanı seç ve son altı aylık HbA1c değerlerini özetle."*

## Araçlar

| Araç | Ne Yapar |
|---|---|
| `list_patients` | projenin hastaları: 30 sentetik persona ve oluşturduğunuz herhangi bir hasta |
| `get_patient_context` | bir hasta için AI'ya hazır bir bağlam, bir token bütçesi dahilinde, her öğe kaynağıyla etiketlenmiş |
| `get_patient_summary` | istediğiniz dilde Uluslararası Hasta Özeti (FHIR `$summary`) |
| `get_timeline` | kaynak türleri arasında tarih sırasına göre kayıt |
| `get_health_patterns` | beta: ne değişti ve ne tekrar ediyor, her bulgu dönemi, kanıtı ve sınırlamalarıyla; teşhisler değil ([rehber](https://developers.anpheros.com/tr/guides/health-patterns)) |
| `get_pattern_evidence` | beta: bir bulgunun arkasındaki her kaynak |
| `get_series` | beta: günde bir değer olarak bir ölçüm, veri kalitesiyle birlikte |
| `compare_periods` | beta: seçtiğiniz iki dönemde bir ölçüm |
| `search_fhir` | standart FHIR R4 araması, bir Bundle döndürür |
| `read_fhir_resource` | bir kaynak veya onun önceki bir sürümü |
| `get_provenance` | bir kaynağı kimin, ne zaman ve hangi sistemden yazdığı |
| `lookup_code` | metne veya koda göre LOINC kodları (ilaçlar için `search_health_terms` kullanın) |
| `search_health_terms` | semptomlar, durumlar ve tedavilerin halka açık kataloğu, 20 dilde ad, eşanlamlı, marka veya kod ile ([rehber](https://developers.anpheros.com/tr/guides/anpheros-search)) |
| `get_health_term` | kodları, adları, MedlinePlus özeti, kaynaklı bağlantıları ve alıntılanan EMA / FDA endikasyonları ile bir katalog girişi |
| `validate_fhir_resource` | kaydetmeden bir kaynağı kontrol eder |
| `create_fhir_resource` | bir kaynağı doğrular, sonra yazar |
| `create_patient` | projede yeni oluşturulmuş bir hasta |
| `import_lab_report` | bir CSV, HL7 v2 ORU^R01 veya JSON laboratuvar raporu laboratuvar Gözlemleri haline gelir |
| `sandbox_status` | bugün kullanılanları, hastaları, depolamayı, sıfırlamaları yazar |
| `reset_sandbox` | 30 sentetik hastayı geri yükler (onay ister) |

Salt okunur araçlar salt okunur olarak işaretlenir ve sıfırlama yıkıcı olarak işaretlenir, böylece riskli eylemlerden önce soran istemciler bunu yapabilir. Sunucu ayrıca sentetik hasta listesini bir kaynak olarak ve üç istem sunar: bir klinisyen özeti, bir laboratuvar CSV içe aktarma ve API üzerinde entegrasyonunuzu oluşturma.

## Nasıl Davranır

- **API ile aynı kurallar.** Her araç, sizin anahtarınızla genel API'yi çağırır: aynı kapsamlar, hız sınırları, doğrulama ve denetim. Salt okunur bir anahtar yazamaz.
- **Köken Bilgisi (Provenance).** Bir aracın yazdığı her şey kaynak `urn:anpheros:mcp` ile kaydedilir, böylece bir aracın ne zaman geldiğini her zaman söyleyebilirsiniz.
- **Hasta verisi veridir.** Araç sonuçları, kayıt içeriğinin asla talimat olarak takip edilmemesi gerektiğini belirten bir not taşır; bu, tıbbi kayıtlar aracılığıyla komut enjeksiyonuna karşı temel bir önlemdir.
- **Onay ile tek kayıt.** Üretim API anahtarları (`sk_live_…`) reddedilir, çünkü bir projenin her hastasına ulaşırlar. Gerçek bir kayıt, yalnızca OAuth aracılığıyla, o kişi onayladıktan sonra bir asistana ulaşır ve her okuma, erişim geçmişinde günlüğe kaydedilir.
- **Standart keşif.** Kimlik bilgileri olmadan sunucu, OAuth korumalı kaynak meta verilerine (RFC 9728) işaret eden bir `WWW-Authenticate` başlığı ile 401 yanıtı verir; asistanlar dinamik istemci kaydı (RFC 7591) aracılığıyla PKCE ile kaydolur. Kayıt yalnızca loopback adreslerini, bilinen düzenleyicilerin uygulama şemalarını ve bilinen yapay zeka asistanlarının geri arama alanlarını kabul eder.

## Sıkça Sorulan Sorular

### MCP sunucusu nedir?
MCP (Model Context Protocol), yapay zeka aracılarının ve kodlama yardımcılarının harici araçları çağırdığı açık bir protokoldür. FHIR için bir MCP sunucusu, verileri sohbet penceresine yapıştırmak yerine aracının sağlık kayıtlarını doğrudan okumasını ve yazmasını sağlar.

### Ücretsiz mi?
Evet. MCP sunucusu ücretsiz kum havuzunda çalışır: proje başına 30 sentetik hasta, günde 10.000'e kadar yazma işlemi, kart gerekmez.

### Bir asistan gerçek bir hastanın kaydını okuyabilir mi?
Yalnızca OAuth aracılığıyla, o kişi onay ekranında asistana onay verdikten sonra, seçtikleri süre boyunca ve yalnızca kendi kayıtlarını (veya baktıkları birinin kaydını) okuyabilir. Özel beta sırasında, OAuth bağlantıları kum havuzu kayıtlarını kullanır.

### Hangi FHIR sürümünü kullanıyor?
HL7 FHIR R4 (4.0.1), Uluslararası Hasta Özeti ile aynı API https://platform.anpheros.com/fhir/R4, ve aynı verinin REST görünümü.

### ChatGPT ile çalışır mı?
ChatGPT bağlayıcıları, sunucunun desteklediği dinamik istemci kaydı ile OAuth kullanır ve geri arama etki alanı kabul edilir. Akışı resmi MCP SDK istemcisi ile test ettik; bir ChatGPT bağlantısı başarısız olursa, support@anpheros.com adresine yazın. Claude Code, Cursor ve VS Code da bir kum havuzu anahtarıyla çalışır.

## İlgili Kaynaklar

- [Bir Yapay Zeka Aracına Tıbbi Kayıtlara Erişim Nasıl Verilir](https://developers.anpheros.com/tr/guides/ai-agent-access-medical-records): Python ile adım adım eğitim
- [Ücretsiz FHIR Veritabanı ve Sandbox](https://developers.anpheros.com/tr/guides/free-fhir-database)
- [Yapay Zeka Araçları ve Tıbbi Veriler](https://developers.anpheros.com/tr/guides/ai-agents-medical-data)
- [LLM Uygulamaları ve Sağlık Verileri](https://developers.anpheros.com/tr/guides/llm-healthcare-data)
- [Hasta Onayı ile Sağlık API'si](https://developers.anpheros.com/tr/guides/healthcare-api-patient-consent)