Picasi'yi Claude Code'a bağla

Konu ne

Picasi’yi Claude Code’da MCP sunucusu olarak kuruyorsun. Bundan sonra rakiplerinle ilgili Updates isteyebilir, kaynakları yönetebilir ya da Report alabilirsin — doğrudan Claude sohbetinde, Picasi uygulamasını açmadan.

Neye gereksinirsin

Bir Picasi API token’ı (yönerge: API token’ı oluştur)
MCP adresi (Settings → AI Connections and Tokens altında bulunur)

A seçeneği: CLI üzerinden yapılandır

Token’ını ve adresi hazır tut

Picasi’de Settings → AI Connections and Tokens sayfasını aç ve MCP URL’yi kopyala. O, https://picasi.app/mcp adresidir ve her Workspace için aynıdır: sunucunun hangisini göstereceğine token karar verir.

MCP sunucusunu ekle

Bir uçbirimde şu komutu çalıştır:

claude mcp add picasi \
  --transport http \
  --url https://picasi.app/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

DEIN_TOKEN yerine kendi token’ını koy.

Bağlantıyı dene

Claude Code’u başlat ve şunu gir:

Picasi Workspace’imde hangi kaynaklar var?

Bağlantı çalışıyorsa Claude gerçek veriyle yanıt verir.

B seçeneği: `.mcp.json` dosyasını doğrudan düzenle

Yapılandırmayı projende dosya olarak tutmayı yeğliyorsan:

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": {
        "Authorization": "Bearer DEIN_TOKEN"
      }
    }
  }
}

Bu dosyayı projenin kökünde .mcp.json olarak kaydet. Claude Code onu kendiliğinden okur.

Düz metin yerine ortam değişkenleri

.mcp.json dosyası Git’te olan projelerde token’ı asla düz metin olarak koyma. İki güvenli yöntem:

1. Genel Claude Code yapılandırması

Projeye özgü bir .mcp.json yerine sunucuyu bir kez genel olarak kur:

claude mcp add picasi \
  --scope user \
  --transport http \
  --url https://picasi.app/mcp \
  --header "Authorization: Bearer DEIN_TOKEN"

Sunucu o zaman depoda .mcp.json olmadan tüm projelerde kullanılabilir.

2. İşlenmeyen bir dosyada ortam değişkeni

Projeye özgü sunucular için: .mcp.json dosyasını depoya işle, ama token’ı ortamdan oku.

{
  "mcpServers": {
    "picasi": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PICASI_API_TOKEN}"
      }
    }
  }
}

PICASI_API_TOKEN değişkenini bir .env dosyasında (.gitignore içinde) ya da doğrudan Claude Code’un başladığı kabukta ayarla:

export PICASI_API_TOKEN=picasi_pat_xxxxxxxxxx
claude

Claude Code değişkeni yalnızca başlangıçta okur. Token değiştirilirse Claude Code’un yeniden başlatılması gerekir.

Birkaç Workspace

Birkaç Picasi Workspace’in varsa (örneğin birkaç müşterisi olan bir ajans) her Workspace için ayrı bir sunucu girdisi oluştur ve ona benzersiz bir ad ver:

{
  "mcpServers": {
    "picasi-kunde-a": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_A}" }
    },
    "picasi-kunde-b": {
      "type": "http",
      "url": "https://picasi.app/mcp",
      "headers": { "Authorization": "Bearer ${env:PICASI_TOKEN_KUNDE_B}" }
    }
  }
}

Adres iki girdide de aynıdır, Workspace token’ın içinde durur. Claude Code sunucu araçlarını karışıklığı önlemek için ayrı ad alanlarında çalıştırır (picasi-kunde-a:list_sources, picasi-kunde-b:list_sources).

Workspace koduyla eski adres

Daha eski yapılandırmalar, sonunda Workspace kodu olan https://picasi.app/mcp/t-xxxxxxxxxx biçiminde bir adres taşır. Değişmeden çalışmayı sürdürür, hiçbir şeyi değiştirmen gerekmez. Yeni girdiler için https://picasi.app/mcp kullan.

İlgili konular

MCP araçları — genel bakış Parametreleriyle kullanılabilir tüm MCP araçları.