Для AI-агентов: markdown этой страницы — /docs/mcp-team.mdиндекс документации — /llms.txt
MCP: team
Обновлено
MCP: team
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
invite_team_member
Invite a team member by tg_username and/or email (≥1 required), with optional permission flags. Creates the member in the invited state. OWNER-ONLY. Returns the created member with its seqNum.
{
"description": "Invite a team member by tg_username and/or email (≥1 required), with optional permission flags. Creates the member in the `invited` state. OWNER-ONLY. Returns the created member with its `seqNum`.",
"domain": "team",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"email": {
"description": "Value for email.",
"format": "email",
"maxLength": 256,
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"type": "string"
},
"permissions": {
"additionalProperties": false,
"description": "Value for permissions.",
"properties": {
"is_ai_settings_allowed": {
"description": "Value for is ai settings allowed.",
"type": "boolean"
},
"is_catalog_read_allowed": {
"description": "Value for is catalog read allowed.",
"type": "boolean"
},
"is_catalog_write_allowed": {
"description": "Value for is catalog write allowed.",
"type": "boolean"
},
"is_contacts_read_allowed": {
"description": "Value for is contacts read allowed.",
"type": "boolean"
},
"is_contacts_write_allowed": {
"description": "Value for is contacts write allowed.",
"type": "boolean"
},
"is_orders_read_allowed": {
"description": "Value for is orders read allowed.",
"type": "boolean"
},
"is_orders_status_change_allowed": {
"description": "Value for is orders status change allowed.",
"type": "boolean"
},
"is_orders_write_allowed": {
"description": "Value for is orders write allowed.",
"type": "boolean"
},
"is_payments_read_allowed": {
"description": "Value for is payments read allowed.",
"type": "boolean"
},
"is_payments_refund_allowed": {
"description": "Value for is payments refund allowed.",
"type": "boolean"
},
"is_reports_allowed": {
"description": "Value for is reports allowed.",
"type": "boolean"
},
"is_settings_access_allowed": {
"description": "Value for is settings access allowed.",
"type": "boolean"
}
},
"type": "object"
},
"tg_username": {
"description": "Value for tg username.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "invite_team_member",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"team:write"
],
"risk": "write",
"scope": "team:write",
"title": "Invite Team Member"
}list_team_members
List the tenant team (operators/members): each with seqNum (the id you pass to update/revoke as seq_num), tg_username/email identity, lifecycle status (invited/active/revoked), and the 12 per-capability permission flags. OWNER-ONLY. 0-cost read.
{
"description": "List the tenant team (operators/members): each with `seqNum` (the id you pass to update/revoke as `seq_num`), tg_username/email identity, lifecycle status (invited/active/revoked), and the 12 per-capability permission flags. OWNER-ONLY. 0-cost read.",
"domain": "team",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_team_members",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"team:read"
],
"risk": "read",
"scope": "team:read",
"title": "List Team Members"
}revoke_team_member
Revoke a team member by seq_num (sets status=revoked — access is removed but the row is retained for audit). Idempotent (already-revoked → revoked:true). OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.
{
"description": "Revoke a team member by `seq_num` (sets status=revoked — access is removed but the row is retained for audit). Idempotent (already-revoked → revoked:true). OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.",
"domain": "team",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"seq_num": {
"description": "Value for seq num.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "revoke_team_member",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"team:write"
],
"risk": "destructive",
"scope": "team:write",
"title": "Revoke Team Member"
}update_team_member
Update a team member by seq_num: change lifecycle status (invited/active/revoked) and/or the permission flags (partial patch). Identity (tg_username/email) is IMMUTABLE here. Idempotent. OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.
{
"description": "Update a team member by `seq_num`: change lifecycle status (invited/active/revoked) and/or the permission flags (partial patch). Identity (tg_username/email) is IMMUTABLE here. Idempotent. OWNER-ONLY. Errors NOT_FOUND for a missing tenant sequence.",
"domain": "team",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"permissions": {
"additionalProperties": false,
"description": "Value for permissions.",
"properties": {
"is_ai_settings_allowed": {
"description": "Value for is ai settings allowed.",
"type": "boolean"
},
"is_catalog_read_allowed": {
"description": "Value for is catalog read allowed.",
"type": "boolean"
},
"is_catalog_write_allowed": {
"description": "Value for is catalog write allowed.",
"type": "boolean"
},
"is_contacts_read_allowed": {
"description": "Value for is contacts read allowed.",
"type": "boolean"
},
"is_contacts_write_allowed": {
"description": "Value for is contacts write allowed.",
"type": "boolean"
},
"is_orders_read_allowed": {
"description": "Value for is orders read allowed.",
"type": "boolean"
},
"is_orders_status_change_allowed": {
"description": "Value for is orders status change allowed.",
"type": "boolean"
},
"is_orders_write_allowed": {
"description": "Value for is orders write allowed.",
"type": "boolean"
},
"is_payments_read_allowed": {
"description": "Value for is payments read allowed.",
"type": "boolean"
},
"is_payments_refund_allowed": {
"description": "Value for is payments refund allowed.",
"type": "boolean"
},
"is_reports_allowed": {
"description": "Value for is reports allowed.",
"type": "boolean"
},
"is_settings_access_allowed": {
"description": "Value for is settings access allowed.",
"type": "boolean"
}
},
"type": "object"
},
"seq_num": {
"description": "Value for seq num.",
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"status": {
"description": "Value for status.",
"enum": [
"invited",
"active",
"revoked"
],
"type": "string"
}
},
"required": [
"seq_num"
],
"type": "object"
},
"name": "update_team_member",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"team:write"
],
"risk": "write",
"scope": "team:write",
"title": "Update Team Member"
}