Trợ lý AI qua MCP

Trợ lý trong app, trợ lý bên ngoài và đối tác cùng dùng bộ công cụ của Gym Master. Mỗi người đăng nhập và tự cấp quyền cho trợ lý.

Kết nối

https://mcp.gymmaster.vn/mcp

Môi trường thử: https://mcp-dev.gymmaster.vn/mcp

Chỉ dán URL rồi đăng nhập OAuth. Chọn đúng nhà và quyền muốn cấp. Không dán API key dùng chung của nhà.

{
  "url": "https://mcp.gymmaster.vn/mcp",
  "transport": "streamable-http"
}

Quyền cấp cho trợ lý

gym:read · crm:read: đọc dữ liệu phòng tập hoặc khách hàng theo quyền của người hỏi.
gym:export · crm:export: đề xuất xuất báo cáo, danh sách; nhận link để người dùng xác nhận trong app.
gym:write · crm:write: chạy thử và tạo write proposal; trợ lý không tự thực hiện.

Quyền hiệu lực là scope OAuth giao với quyền thật của người dùng. Nhân viên chỉ có view_own thì chỉ thấy phần của mình. Mua gói không cấp thêm quyền cho nhân viên.

Xác nhận trong Gym Master

Tool ghi trả dryRun=true, executed=false và link Xác nhận. Mở link bằng đúng tài khoản, đúng nhà. Coi lại nội dung rồi bấm thẻ Xác nhận sẵn có. Link tự hết hạn sau 15 phút; mã chỉ dùng một lần. Mở link không thực thi gì.

Đọc và xuất cần AI Đọc hoặc AI Làm; write proposal cần AI Làm. Cả lúc gọi tool và lúc bấm Xác nhận đều kiểm consent và gói còn hiệu lực.

Không mở tạo phiếu thu, gia hạn, thu nợ hoặc chi hoa hồng.

Bộ công cụ

Gọi gym_tool_catalog hoặc crm_tool_catalog để lấy schema hiện tại. Gọi từng tool bằng {args:{...}} theo schema đó. Có doanh thu NET, giải thích lỗi, xuất báo cáo theo tên, bán hàng, tái ký và tra hoa hồng.

call_agents_searchcall_call_flows_searchcall_calls_searchcall_campaigns_searchcall_ivr_flows_searchcall_phone_numbers_searchcall_queues_searchads_catalogads_readcomm_add_ai_bot_qacomm_ads_changecomm_agents_performancecomm_assign_to_mecomm_bot_statscomm_channels_statuscomm_close_conversationcomm_conversations_searchcomm_create_ai_botcomm_inbox_breakdowncomm_messages_getcomm_messages_volumecomm_sales_pipelinecomm_update_ai_botcrm_add_notecrm_add_tagcrm_appointments_querycrm_assign_ownercrm_contacts_activitycrm_contacts_carecrm_contacts_exportcrm_contacts_querycrm_contracts_searchcrm_create_appointmentcrm_create_contract_from_quotationcrm_create_leadcrm_create_opportunitycrm_create_quotationcrm_create_taskcrm_move_opportunity_stagecrm_opportunities_exportcrm_opportunities_querycrm_products_searchcrm_quotation_templates_listcrm_quotations_searchcrm_remove_tagcrm_reports_ads_exportcrm_reports_ads_querycrm_reports_analytics_querycrm_reports_call_outcome_exportcrm_reports_call_outcome_querycrm_reports_campaign_querycrm_reports_care_dashboard_querycrm_reports_care_tasks_exportcrm_reports_care_tasks_querycrm_reports_contact_querycrm_reports_contracts_exportcrm_reports_contracts_querycrm_reports_conversations_exportcrm_reports_conversations_querycrm_reports_customers_exportcrm_reports_customers_querycrm_reports_exportcrm_reports_forecast_querycrm_reports_journey_exportcrm_reports_journey_querycrm_reports_kpi_querycrm_reports_lead_querycrm_reports_lead_source_exportcrm_reports_lead_source_querycrm_reports_lead_speed_exportcrm_reports_lead_speed_querycrm_reports_multi_module_exportcrm_reports_multi_module_querycrm_reports_opportunity_querycrm_reports_pipeline_campaign_querycrm_reports_pipeline_exportcrm_reports_pipeline_querycrm_reports_querycrm_reports_quotations_exportcrm_reports_quotations_querycrm_reports_reconciliation_exportcrm_reports_reconciliation_querycrm_reports_retention_exportcrm_reports_retention_querycrm_reports_satisfaction_exportcrm_reports_satisfaction_querycrm_reports_support_exportcrm_reports_support_querycrm_reports_survey_querycrm_reports_team_activity_exportcrm_reports_team_activity_querycrm_reports_win_loss_exportcrm_reports_win_loss_querycrm_sales_process_alertscrm_sales_process_casecrm_sales_process_case_actioncrm_sales_process_createcrm_sales_process_disablecrm_sales_process_enablecrm_sales_process_getcrm_sales_process_listcrm_sales_process_patchcrm_sales_process_paymentscrm_sales_process_runscrm_sales_process_simulatecrm_sales_process_templatescrm_sales_process_todaycrm_sales_process_validatecrm_sales_process_workspacecrm_select_quotation_print_templatecrm_send_quotation_emailcrm_set_lifecyclecrm_tasks_querycrm_tickets_querycrm_workspace_summarydms_catalog_products_searchdms_checkins_searchdms_daily_plans_getdms_daily_plans_searchdms_orders_searchdms_outlets_searchdms_routes_searchdms_van_inventory_getdms_van_inventory_low_stockdms_van_load_historyeinvoice_invoices_geteinvoice_invoices_searcheinvoice_reports_summaryeinvoice_series_listeinvoice_settings_listgym_book_classgym_book_pt_sessiongym_checkins_querygym_classbookings_querygym_classes_searchgym_commissions_querygym_contracts_exportgym_contracts_querygym_create_packagegym_devices_statusgym_errors_explaingym_freeze_contractgym_lockers_reportgym_loyalty_reportgym_manual_checkingym_member_changesgym_member_historygym_members_exportgym_members_querygym_print_contractgym_print_ticketgym_ptsessions_querygym_register_membergym_reports_access_querygym_reports_allocation_querygym_reports_branch_querygym_reports_business_querygym_reports_checkin_by_period_querygym_reports_checkin_detail_querygym_reports_churn_querygym_reports_churn_risk_querygym_reports_class_pt_querygym_reports_customer_analytics_querygym_reports_debt_querygym_reports_exportgym_reports_fund_querygym_reports_goal_outcomes_querygym_reports_goal_progress_querygym_reports_kpi_querygym_reports_lead_funnel_querygym_reports_loyalty_querygym_reports_members_querygym_reports_progress_querygym_reports_pt_commission_querygym_reports_pt_training_querygym_reports_registrations_querygym_reports_remaining_querygym_reports_rental_querygym_reports_revenue_breakdown_querygym_reports_revenue_by_service_querygym_reports_service_frequency_querygym_reports_tickets_querygym_retention_reportgym_revenue_reportgym_sales_reportgym_summary_reportgym_unfreeze_contracthrm_attendance_devices_listhrm_clock_history_dailyhrm_clock_history_timelinehrm_contracts_expiringhrm_employee_credentials_listhrm_employees_gethrm_employees_searchhrm_inbox_listhrm_insurance_summaryhrm_me_clock_todayhrm_me_contractshrm_me_payslipshrm_me_requestshrm_me_summaryhrm_onboarding_listhrm_org_unitshrm_performance_meetingshrm_raw_punches_searchhrm_recruitment_listhrm_report_attendancehrm_report_overtimehrm_training_courseshrm_training_learnerhrm.correction.submithrm.inbox.approvehrm.inbox.rejecthrm.leave.submithrm.onboarding.tickhrm.overtime.submithrm.training.completemarketing_activate_workflowmarketing_automation_catalogmarketing_check_graphmarketing_create_web_formmarketing_create_workflow_from_graphmarketing_delete_landingmarketing_email_campaigns_getmarketing_email_campaigns_searchmarketing_email_templates_searchmarketing_get_workflow_statsmarketing_integrations_listmarketing_list_landing_pagesmarketing_list_web_formsmarketing_list_workflow_templatesmarketing_list_workflowsmarketing_pause_workflowmarketing_publish_landingmarketing_reports_overviewmarketing_save_landing_draftmarketing_sender_profiles_listmarketing_unpublish_landingmarketing_update_web_formmarketing_update_workflow_graphmarketing_zns_templates_searchget_my_recent_mailoffice_activate_automationoffice_add_checklist_itemoffice_add_task_commentoffice_approve_approval_taskoffice_approve_taskoffice_automation_catalogoffice_cancel_eventoffice_check_graphoffice_create_approval_instanceoffice_create_automation_from_graphoffice_create_eventoffice_create_recordoffice_create_taskoffice_create_task_from_chatoffice_create_task_listoffice_delete_recordoffice_delete_taskoffice_get_approval_instanceoffice_get_recordoffice_list_approval_instancesoffice_list_automationsoffice_list_my_calendaroffice_list_recordsoffice_list_stuck_tasksoffice_list_tasksoffice_pause_automationoffice_read_group_chatoffice_reject_approval_taskoffice_restore_taskoffice_return_taskoffice_simulate_automationoffice_transfer_approval_taskoffice_update_automation_graphoffice_update_eventoffice_update_recordoffice_update_taskpayment_intents_getpayment_refunds_searchpayment_reports_overviewpayment_subscriptions_searchpayment_transactions_getpayment_transactions_searchsales_customers_searchsales_orders_getsales_orders_searchsales_products_searchsales_products_stock

Khi chưa gọi được

401: đăng nhập lại. insufficient_scope: cấp thêm scope; quyền thật của người dùng vẫn phải đủ. ai.package_missing: nhà chưa có gói AI Đọc/AI Làm hoặc consent hết hiệu lực. Gói bị thu hồi sau lúc lập đề xuất thì Xác nhận cũng bị chặn.