Точки данных

Точки данных каждой системы

Полный каталог Resources и Tools, которые MCP-first система должна предоставлять по каждой предметной области — от системных метаданных до Admin & Security.

MCP-first система полностью описывает свои возможности. Это относится не только к архитектуре или модели рисков — это относится к каждой предметной сущности, которую знает система. Данный каталог показывает, какие Resources и Tools современная система должна предоставлять по каждой предметной области.

Базовый принцип: каждой сущности нужны минимум list, search, get, create, update, archive, audit, permissions, связанные ресурсы и рекомендуемые следующие действия. delete используется редко — он заменяется archive или защищается как критическое действие со Step-up Auth.


Системные метаданные

Основа каждой агентной сессии. Эти Resources и Tools нужны каждому агенту перед выполнением каких-либо предметных действий: какие возможности существуют? Что мне разрешено? Какие политики действуют?

Resources

Resources
  • system.capabilities
  • system.current_user
  • system.current_tenant
  • system.permissions
  • system.audit_policy
  • system.risk_policy
  • system.available_workflows
  • system.health

Tools

Tools
  • system.describe_capability Low
  • system.request_confirmation Low
  • system.check_permission Low
  • system.get_audit_log Medium
  • system.explain_denial Low

Пользователи и идентичность

Управление пользователями, ролями, сессиями и идентичностями агентов. Большинство операций записи здесь имеют уровень не ниже high — изменения ролей и ротация секретов всегда critical.

Resources

Resources
  • users.list
  • users.get
  • users.current
  • roles.list
  • permissions.list
  • sessions.list
  • api_clients.list
  • agent_identities.list

Tools

Tools
  • users.invite High
  • users.update_role Critical
  • users.disable High
  • users.enable High
  • users.delete Critical
  • sessions.revoke High
  • api_clients.create High
  • api_clients.rotate_secret Critical
  • agent_identities.create High
  • agent_identities.disable High
  • permissions.grant Critical
  • password.read Forbidden for AI

Тенанты

Управление арендаторами в мультитенантных системах. Каждый доступ к данным тенанта должен быть привязан к тенанту. Экспорт и архивирование тенантов имеют уровень critical.

Resources

Resources
  • tenants.list
  • tenants.get
  • tenants.settings
  • tenants.members
  • tenants.audit_log

Tools

Tools
  • tenants.update_settings High
  • tenants.invite_member High
  • tenants.remove_member High
  • tenants.create_export Critical
  • tenants.archive Critical

Контакты / CRM

Контакты — наиболее частая точка входа для агентов в продажах и поддержке. Истории коммуникаций и личные заметки могут содержать персональные данные по GDPR — доступ ИИ должен ограничиваться в зависимости от контекста и цели агента.

Resources

Resources
  • contacts.list
  • contacts.search
  • contacts.get
  • contacts.timeline
  • contacts.communication_history
  • contacts.related_projects
  • contacts.tags

Tools

Tools
  • contacts.create Medium
  • contacts.update Medium
  • contacts.merge High
  • contacts.add_note Medium
  • contacts.add_tag Low
  • contacts.remove_tag Low
  • contacts.archive High
  • contacts.request_data_export Critical

Компании

Основные данные компаний и аккаунтов с профилями покупок и историей коммуникаций. Тесно связаны с контактами и проектами.

Resources

Resources
  • companies.list
  • companies.search
  • companies.get
  • companies.contacts
  • companies.projects
  • companies.profile
  • companies.purchase_profile
  • companies.communication_history

Tools

Tools
  • companies.create Medium
  • companies.update Medium
  • companies.assign_contact Medium
  • companies.update_purchase_profile Medium
  • companies.add_note Medium
  • companies.archive High

Проекты

Проекты — центральный контекстный хаб: они связывают контакты, файлы, активности и рекомендуемые следующие действия. Агенты интенсивно используют контекст проекта — generate_summary и recommend_next_action особенно востребованы.

Resources

Resources
  • projects.list
  • projects.search
  • projects.get
  • projects.status
  • projects.timeline
  • projects.files
  • projects.contacts
  • projects.exposes
  • projects.activities
  • projects.recommended_next_actions

Tools

Tools
  • projects.create Medium
  • projects.update Medium
  • projects.change_status High
  • projects.assign_contact Medium
  • projects.add_note Medium
  • projects.attach_file Medium
  • projects.generate_summary Low
  • projects.recommend_next_action Low
  • projects.archive High

Файлы

Файлы могут быть крайне чувствительными — договоры, кадровые документы, финансовые материалы. Ссылки для скачивания требуют срока действия, токенов и аудита. Агенты не должны загружать содержимое файлов в контекст без проверки.

Resources

Resources
  • files.list
  • files.get_metadata
  • files.preview
  • files.permissions
  • files.related_entities

Tools

Tools
  • files.upload Medium
  • files.attach_to_project Medium
  • files.generate_download_link High
  • files.revoke_download_link High
  • files.rename Medium
  • files.move Medium
  • files.archive High

E-mail и коммуникации

E-mail — наиболее рискованная область для автономных агентов: внешняя коммуникация имеет юридические последствия, может передавать персональные данные и необратима. Политика однозначна: агенты вправе создавать черновики, но не отправлять.

Resources

Resources
  • emails.list
  • emails.get
  • emails.thread
  • emails.templates
  • emails.delivery_status
  • emails.engagement_status
  • communications.timeline

Tools

Tools
  • emails.create_draft Medium
  • emails.preview Low
  • emails.send Critical
  • emails.schedule_send Critical
  • emails.attach_file Medium
  • emails.generate_download_link High
  • emails.cancel_scheduled_send High
  • communications.add_note Medium

Календарь

Создание встреч несёт умеренный риск. Приглашение внешних лиц или отмена встреч затрагивает других участников и имеет уровень high.

Resources

Resources
  • calendar.events.list
  • calendar.events.get
  • calendar.availability
  • calendar.connected_accounts

Tools

Tools
  • calendar.create_event Medium
  • calendar.update_event Medium
  • calendar.cancel_event High
  • calendar.invite_contact High
  • calendar.find_free_slot Low

Напоминания и задачи

Напоминания и задачи — наиболее безопасные автономные действия в системе. Они не создают внешних эффектов и легко обратимы. Агенты могут создавать и управлять ими без подтверждения.

Resources

Resources
  • reminders.list
  • reminders.get
  • tasks.list
  • tasks.get
  • tasks.assigned_to_me

Tools

Tools
  • reminders.create Low
  • reminders.update Low
  • reminders.complete Low
  • reminders.cancel Low
  • tasks.create Low
  • tasks.assign Medium
  • tasks.update_status Low
  • tasks.complete Low

Отчёты и аналитика

Отчёты и экспорты могут содержать чувствительные персональные данные. Классификация зависит не от самого Tool, а от содержимого: анонимные агрегаты имеют уровень medium, экспорты с персональными данными — critical.

Resources

Resources
  • reports.available
  • reports.get
  • analytics.kpis
  • analytics.activity_summary
  • analytics.risk_summary

Tools

Tools
  • reports.generate Medium
  • reports.schedule Medium
  • reports.export_anonymized Medium
  • reports.export_personal_data Critical
  • analytics.explain_metric Low
  • analytics.compare_periods Low

Биллинг

Почти все операции записи в биллинге имеют уровень critical. ИИ здесь вправе максимум читать, объяснять или подготавливать — но никогда не действовать автономно. Выполнение платежей — одна из жёстких границ в системе.

Resources

Resources
  • billing.plan
  • billing.invoices
  • billing.payment_methods
  • billing.usage

Tools

Tools
  • billing.download_invoice Low
  • billing.change_plan Critical
  • billing.update_payment_method Critical
  • billing.cancel_subscription Critical
  • payment.execute Critical

Admin & Security

Функции безопасности — наиболее чувствительный слой системы. Многие из них не просто critical, но полностью заблокированы для ИИ. Журналы аудита, управление сессиями и ротация API-ключей никогда не должны изменяться агентом автономно.

Resources

Resources
  • security.settings
  • security.audit_log
  • security.active_sessions
  • security.api_keys
  • security.connected_clients
  • security.risk_events

Tools

Tools
  • security.export_audit_log Critical
  • security.revoke_session Critical
  • security.disable_client Critical
  • security.rotate_api_key Critical
  • security.update_policy Critical
  • secrets.rotate Critical
  • raw_access_token.read Forbidden for AI
  • private_key.read Forbidden for AI
  • full_database_export Forbidden for AI