MCP Sunucusu
Tek bir API anahtarıyla, MCP destekleyen herhangi bir yapay zeka istemcisinden Havadis'in yapay zeka yeteneklerine erişin.
https://api.gethavadis.co/api/mcpmcp/streamable-http · 2024-11-05API anahtarı oluşturun
Panel → Ayarlar → Geliştirici sekmesinden bir API anahtarı oluşturun. Anahtar yalnızca bir kez gösterilir; güvenli bir yerde saklayın.
İstemcinizi yapılandırın
Anahtarı Bearer token olarak ekleyin. Aşağıdaki Hazır yapılandırmalar bölümünde Claude Desktop, Cursor ve curl örnekleri var.
Aracı çağırın
İstemci bağlandıktan sonra `tools/list` ile kullanılabilir araçları listeleyin ve `tools/call` ile çağırın.
Havadis MCP sunucusu Bearer token ile kimlik doğrular. Token biçimi:
havadis_<prefix>_<secret>Authorization: Bearer havadis_<prefix>_<secret>POST https://api.gethavadis.co/api/tenants/current/api-keys # Mint a new key (409 if one exists)
POST https://api.gethavadis.co/api/tenants/current/api-keys/rotate # Atomic revoke + mint
GET https://api.gethavadis.co/api/tenants/current/api-keys # Read current key metadata (no plaintext)
DELETE https://api.gethavadis.co/api/tenants/current/api-keys # Revoke active keyBu uç noktalar yalnızca panel kullanıcınız (JWT ile) tarafından kullanılır — MCP istemcisi değil. Düz metin anahtar yalnızca oluşturma veya yenileme anında bir kez döner.
Her araç ihtiyacı olan kapsamları belirtir. Şu anda oluşturulan anahtarlar tüm kapsamlara sahiptir:
brands:readbrands:writecontent:readtopics:writejobs:readjobs:writecredits:readbilling:readListedeki araçlar canlı yapılandırmadan doldurulur — yeni eklenen bir araç 5 dakika içinde burada görünür.
brands:readList the brands owned by the authenticated tenant. Use this to discover brand IDs before calling brand-scoped tools (e.g. list_content, create_job).
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}brands:readFetch a single brand the authenticated tenant owns, including its description, logo and primary color. Returns 404-equivalent if the brand does not belong to the tenant.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"required": [
"brandId"
],
"additionalProperties": false
}content:readList generated content for one of the tenant's brands, newest first. Pagination via `page`/`limit` (defaults: page=1, limit=20). Result items contain id, title, contentType and createdAt — call `get_content` for full body.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"required": [
"page",
"limit",
"brandId"
],
"additionalProperties": false
}content:readFetch a single generated content item including its full body, summary and metadata blocks (SEO, AEO, GEO, social variants). The `brandId` must own the content — cross-brand fetches return null.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
"contentId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"required": [
"brandId",
"contentId"
],
"additionalProperties": false
}credits:readReturn the authenticated user's credit balance. Credits are pooled at the user level and never expire — they roll over indefinitely. `isUnlimited: true` users have no balance cap (`balance` is reported as 0 for them; check `isUnlimited` first).
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}credits:readPaginated credit ledger for the authenticated user. Each entry records a deduction, top-up, subscription grant or welcome bonus. Optional `brandId` narrows to one brand's spend.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"page": {
"default": 1,
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"required": [
"page",
"limit"
],
"additionalProperties": false
}billing:readReturn the tenant's current plan and Stripe subscription state: `plan` (free / pro / pro_plus), `subscriptionStatus`, `currentPeriodEnd`, `cancelAtPeriodEnd`, `canceledAt`. Free-tier tenants have null subscription fields. Use `list_plans` to discover upgrade targets.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}billing:readList subscription plans available to the tenant — Pro and Pro+. Each plan exposes monthly price (cents), credits granted per month, and an `isCurrent` flag against the tenant's current plan. Stripe checkout / cancel actions are intentionally not exposed via MCP; manage subscriptions in the web dashboard.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {},
"additionalProperties": false
}jobs:readList content-generation jobs for a brand, newest first. Each item carries the job status (queued / running / completed / failed) and timing/credit summary. Use `get_job` for the full pipeline detail and recent agent logs.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
"page": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
}
},
"required": [
"brandId",
"page",
"limit"
],
"additionalProperties": false
}jobs:readFetch a job along with its pipeline progress and recent agent logs. Poll this every 2-5 seconds while `status` is queued or running. `pipeline` lists each agent step with timing; `logs` is the latest activity feed (most recent last).
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
"jobId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
"logsLimit": {
"default": 50,
"type": "integer",
"minimum": 0,
"maximum": 200
}
},
"required": [
"brandId",
"jobId",
"logsLimit"
],
"additionalProperties": false
}brands:writeCreate a new brand for the authenticated tenant. Free-tier tenants are limited to 1 brand and will receive a `feature_locked` error on the second create attempt — upgrade to Pro for unlimited brands. The brand becomes the default automatically when it is the first one.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"slug": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
},
"logoUrl": {
"default": null,
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "null"
}
]
},
"primaryColor": {
"default": "#000000",
"type": "string",
"pattern": "^#[0-9A-Fa-f]{6}$"
},
"industry": {
"default": "",
"type": "string",
"maxLength": 100
},
"website": {
"default": "",
"anyOf": [
{
"type": "string",
"format": "uri"
},
{
"type": "string",
"const": ""
}
]
},
"description": {
"default": "",
"type": "string",
"maxLength": 500
}
},
"required": [
"name",
"logoUrl",
"primaryColor",
"industry",
"website",
"description"
],
"additionalProperties": false
}topics:writeEnqueue an LLM-driven topic discovery run for the brand. Costs 3 credits, charged when the run is enqueued. Returns immediately with `{runId, status, contentType}` — the run executes asynchronously on a worker and the resulting suggestions appear in the dashboard. Requires the brand to have a completed knowledge analysis.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
},
"contentType": {
"default": "blog",
"type": "string",
"enum": [
"blog",
"instagram",
"x_thread"
]
},
"language": {
"default": "en",
"type": "string",
"minLength": 2,
"maxLength": 5
}
},
"required": [
"brandId",
"contentType",
"language"
],
"additionalProperties": false
}jobs:writeEnqueue a content-generation pipeline job. Costs depend on the tenant plan (free skips SEO/AEO/GEO). Free-tier tenants are limited to the 'short' word-count range; attempting 'medium', 'long' or 'unlimited' returns a `feature_locked` error. The pipeline runs asynchronously — poll `get_job` every 2-5s while `status` is queued or running.
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"contentType": {
"type": "string",
"enum": [
"blog",
"instagram",
"x_thread"
]
},
"brief": {
"type": "string",
"minLength": 10,
"maxLength": 4000
},
"styleUrls": {
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"researchUrls": {
"default": [],
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"format": "uri"
}
},
"keywords": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"targetPersonaId": {
"default": null,
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"instructions": {
"default": "",
"type": "string",
"maxLength": 2000
},
"language": {
"default": "en",
"type": "string",
"minLength": 2,
"maxLength": 5
},
"wordCountRange": {
"default": null,
"anyOf": [
{
"type": "string",
"enum": [
"short",
"medium",
"long",
"unlimited"
]
},
{
"type": "null"
}
]
},
"suggestionId": {
"default": null,
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"brandId": {
"type": "string",
"pattern": "^[a-f\\d]{24}$"
}
},
"required": [
"contentType",
"brief",
"styleUrls",
"researchUrls",
"keywords",
"targetPersonaId",
"instructions",
"language",
"wordCountRange",
"suggestionId",
"brandId"
],
"additionalProperties": false
}Hesap başına uygulanır (1 aktif anahtar = 1 hesap). Plan yükseldikçe izin verilen istek hacmi artar.
| Plan | Süre | Limit |
|---|---|---|
| Free | 60 sn | 60 |
| Pro | 60 sn | 300 |
| Pro Plus | 60 sn | 1000 |
Hatalar JSON-RPC biçiminde döner. Programatik kontrol için en güvenilir alan `code`'dur.
Plan limitine takıldınız (örn. ücretsiz hesap ikinci bir marka oluşturmaya çalışıyor). `requiredPlan` alanı yükseltmeniz gereken planı belirtir.
{
"code": "feature_locked",
"message": "Your plan allows up to 1 brand(s).",
"details": {
"featureKey": "brand_limit",
"requiredPlan": "pro"
}
}API anahtarınız bu araç için gereken kapsama sahip değil.
{
"code": "scope_denied",
"message": "Tool create_brand requires scope brands:write"
}Hesap istek limitini aştınız. `retryAfterMs` süresi kadar bekleyip yeniden deneyin.
{
"code": "rate_limit_exceeded",
"message": "MCP rate limit exceeded for plan \"free\". Retry after 42s.",
"retryAfterMs": 42000
}Hesap başına yalnızca bir aktif anahtar olabilir. Yeni anahtar için /rotate uç noktasını kullanın.
{
"code": "api_key_exists",
"prefix": "abcd1234",
"message": "An API key already exists. Use /rotate to replace it."
}Yaygın MCP istemcileri için kopyala-yapıştır kullanabileceğiniz örnekler.
{
"mcpServers": {
"havadis": {
"type": "http",
"url": "https://api.gethavadis.co/api/mcp",
"headers": {
"Authorization": "Bearer havadis_<your-key-here>"
}
}
}
}