Actora Tenant — Hosted Chat, Tasks & Usage
Actora B-side tools: hosted chat, sessions, tasks, tenant plan and usage.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"actora-tenant": {
"url": "https://actora.codes/mcp/tenant"
}
}
}원격 엔드포인트
https://actora.codes/mcp/tenantstreamable-http할 수 있는 일
도구 목록
도구 (9)
🟢actora_gateway_tenant(access_token, accessToken)
Get tenant profile, plan, quota. Requires access_token (registered-user JWT); `Authorization: Bearer` is injected automatically.
입력 스키마
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT token (registered-user auth)"
},
"accessToken": {
"type": "string",
"description": "Deprecated alias of access_token"
}
}
}⚪actora_gateway_chat(message, agent_id, prompt, history, tenant_key_id, ...)
Single-turn conversation with an agent (SSE stream collected into a reply). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"message": {
"type": "string",
"description": "User message"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt (bypasses agent lookup)"
},
"history": {
"type": "array",
"description": "Optional conversation history [{role, content}]"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"message"
]
}🟡actora_gateway_create_session(agent_id, title, access_token)
Create a conversation session (dialog container; idempotent). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"agent_id": {
"type": "integer",
"description": "Agent ID"
},
"title": {
"type": "string",
"description": "Optional session title"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
}
}🟡actora_gateway_create_task(session_id, message, agent_id, prompt, tenant_key_id, ...)
Create a background task in a session (returns immediately with taskId; queued→running→done). May return 403 PARALLEL_TASKS_DISABLED. Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID (from actora_gateway_create_session)"
},
"message": {
"type": "string",
"description": "Task instruction"
},
"agent_id": {
"type": "integer",
"description": "Agent ID (omit when using inline prompt)"
},
"prompt": {
"type": "string",
"description": "Inline mode: caller-supplied system prompt"
},
"tenant_key_id": {
"type": "string",
"description": "BYOK: id of a stored tenant-owned API key"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id",
"message"
]
}🟢actora_gateway_get_task(task_id, access_token)
Get task detail by id (status, result, error). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_gateway_list_tasks(session_id, access_token)
List all tasks of a session. Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"session_id": {
"type": "string",
"description": "Session ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"session_id"
]
}🔴actora_gateway_cancel_task(task_id, access_token)
Cancel a task (queued → cancelled; running → aborted; terminal states are idempotent). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"task_id": {
"type": "string",
"description": "Task ID"
},
"access_token": {
"type": "string",
"description": "Gateway JWT — registered-user auth (required)"
}
},
"required": [
"task_id"
]
}🟢actora_tenant_plans(access_token)
List platform plans for B-side tenants (Free / Pro / Enterprise: quota, rate limit, concurrency, BYOK). Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}⚪actora_tenant_usage(days, access_token)
Token/tool-call usage summary and daily timeline for the current tenant. Requires access_token (registered-user JWT).
입력 스키마
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"description": "Lookback window in days (1..365, default 30)"
},
"access_token": {
"type": "string",
"description": "Gateway JWT (required)"
}
},
"required": [
"access_token"
]
}커뮤니티
증거