TrackWork MCP ve REST API entegrasyonu

Kişisel API token ile TrackWork hesabınızı uyumlu MCP istemcilerine bağlayın veya REST API üzerinden proje verilerinize erişin.

Son güncelleme:

1. Kişisel API token oluşturun

Dashboard içindeki Ayarlar sayfasından bir API token oluşturun. Token'ın düz metin değeri yalnızca bir kez gösterilir. Token sizin hesabınızın verilerine erişim sağlar; herkese açık depolara, sohbetlere veya müşteri bağlantılarına eklemeyin. Kullanmadığınız ya da açığa çıktığını düşündüğünüz token'ı Ayarlar'dan iptal edin.

2. MCP istemcisini bağlayın

Streamable HTTP destekleyen MCP istemcinizde sunucu adresini ve Authorization başlığını tanımlayın. Aşağıdaki YOUR_TOKEN örneğini kendi token'ınızla yalnızca yerel istemci ayarlarınızda değiştirin. İstemcinin kimlik doğrulama ve taşıma desteği değişebilir.

{
  "mcpServers": {
    "trackwork": {
      "url": "https://trackwork.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

3. REST ile salt okunur bir istek deneyin

Aynı Bearer token, /api/v1 uçlarında kullanılabilir. Aşağıdaki örnekler yalnızca hesabı ve proje listesini okur. TRACKWORK_API_TOKEN değişkenini güvenli yerel ortamınızda tanımlayın.

curl https://trackwork.app/api/v1/me \
  -H "Authorization: Bearer $TRACKWORK_API_TOKEN"

curl https://trackwork.app/api/v1/projects \
  -H "Authorization: Bearer $TRACKWORK_API_TOKEN"

Desteklenen işlemler

REST v1 kapsamında hesabı ve müşterileri listeleme; proje listeleme, oluşturma ve güncelleme; adım ve alt görev ekleme/güncelleme; ödeme kaydı ve günlük durum ekleme uçları bulunur. Yazma işlemleri hesabınızdaki gerçek veriyi değiştirir. Otomasyonlarda hangi proje üzerinde işlem yaptığınızı doğrulayın.

  • GET /api/v1/me
  • GET /api/v1/clients
  • GET veya POST /api/v1/projects
  • GET veya PATCH /api/v1/projects/:id
  • POST /api/v1/projects/:id/steps
  • PATCH /api/v1/steps/:id
  • POST /api/v1/steps/:id/sub-steps
  • PATCH /api/v1/sub-steps/:id
  • POST /api/v1/projects/:id/payments
  • POST /api/v1/today-status