Werkzeuge

Diese Werkzeuge werden aus demselben Register wie die REST-API erzeugt. Eine Verbindung sieht nur die Werkzeuge, die ihre Rechte erlauben.

Tool	What it does	Permission	Effect	REST operationId
`add_conversation_note`	Create conversation note	`inbox:write`	Write (no outside effect)	`create_conversation_note`
`apply_landing_page_ops`	Edit landing page draft	`landing:write`	Write (no outside effect)	`apply_landing_page_ops`
`control_newsletter`	Control newsletter send	`newsletters:send`	Send (reaches other people)	`control_newsletter`
`export_contacts`	Create contact export	`contacts:read`	Write (no outside effect)	`create_contact_export`
`get_account_overview`	Get account overview	`account:read`	Read	`get_account_overview`
`get_ai_reply_settings`	Get AI reply settings	`ai:settings_read`	Read	`get_ai_reply_settings`
`get_automation`	Get automation	`automations:read`	Read	`get_automation`
`get_automation_catalog`	Get automation catalog	`automations:read`	Read	`get_automation_catalog`
`get_business_profile`	Get business profile	`settings:read`	Read	`get_business_profile`
`get_contact`	Get contact	`contacts:read`	Read	`get_contact`
`get_conversation`	Get conversation	`inbox:read`	Read	`get_conversation`
`get_landing_catalog`	Get landing catalog	`landing:read`	Read	`get_landing_catalog`
`get_landing_page`	Get landing page	`landing:read`	Read	`get_landing_page`
`get_newsletter`	Get newsletter	`newsletters:read`	Read	`get_newsletter`
`get_send_status`	Get send	`sends:read`	Read	`get_send`
`list_automation_runs`	List automation runs	`automations:read`	Read	`list_automation_runs`
`list_automations`	List automations	`automations:read`	Read	`list_automations`
`list_conversations`	List conversations	`inbox:read`	Read	`list_conversations`
`list_followup_sequences`	List follow-up sequences	`followups:read`	Read	`list_followup_sequences`
`list_knowledge_documents`	List knowledge documents	`knowledge:read`	Read	`list_knowledge_documents`
`list_learned_answers`	List learned answers	`ai:settings_read`	Read	`list_learned_answers`
`list_media`	List media	`media:read`	Read	`list_media`
`list_newsletters`	List newsletters	`newsletters:read`	Read	`list_newsletters`
`list_templates`	List templates	`templates:read`	Read	`list_templates`
`plan_newsletter_send`	Preview newsletter send	`newsletters:read`	Read	`get_newsletter_send_preview`
`publish_landing_page`	Publish landing page	`landing:publish`	Send (reaches other people)	`publish_landing_page`
`run_automation`	Start automation run	`automations:run`	Send (reaches other people)	`create_automation_run`
`save_automation`	Create automation	`automations:write`	Write (no outside effect)	`create_automation`, `update_automation`
`save_contact`	Create contact	`contacts:write`	Write (no outside effect)	`create_contact`, `update_contact`
`save_followup_sequence`	Create follow-up sequence	`followups:write`	Write (no outside effect)	`create_followup_sequence`, `update_followup_sequence`
`save_learned_answer`	Create learned answer	`ai:settings`	Write (no outside effect)	`create_learned_answer`, `update_learned_answer`
`save_newsletter`	Create newsletter	`newsletters:write`	Write (no outside effect)	`create_newsletter`, `update_newsletter`
`save_template`	Create template	`templates:write`	Write (no outside effect)	`create_template`, `update_template`
`search_contacts`	Search contacts	`contacts:read`	Read	`search_contacts`
`search_knowledge`	Search knowledge	`knowledge:read`	Read	`search_knowledge`
`send_newsletter`	Send newsletter	`newsletters:send`	Send (reaches other people)	`send_newsletter`
`send_optin_confirmations`	Create opt-in confirmations	`sends:create`	Send (reaches other people)	`create_optin_confirmations`
`send_template_message`	Send template message	`sends:create`	Send (reaches other people)	`send_template_message`
`send_test_newsletter`	Send test newsletter	`newsletters:test`	Send (reaches other people)	`send_test_newsletter`
`send_text_message`	Send text message	`sends:create`	Send (reaches other people)	`send_text_message`
`set_automation_status`	Set automation status	`automations:write`	Write (no outside effect)	`set_automation_status`
`submit_templates`	Submit templates	`templates:submit`	Send (reaches other people)	`create_template_submissions`
`tag_contacts`	Tag contacts	`contacts:write`	Write (no outside effect)	`tag_contacts`
`unsubscribe_contact`	Unsubscribe contact	`contacts:unsubscribe`	Write (no outside effect)	`unsubscribe_contact`
`update_ai_reply_settings`	Update AI reply settings	`ai:settings`	Write (no outside effect)	`update_ai_reply_settings`
`update_business_profile`	Update business profile	`settings:write`	Write (no outside effect)	`update_business_profile`
`update_conversation`	Update conversation	`inbox:write`	Write (no outside effect)	`update_conversation`
`upload_file`	Upload media file	`media:write`	Write (no outside effect)	`create_media`

Die Hinweise auf jeder Werkzeugseite sind die MCP-Annotationen: readOnlyHint (das Werkzeug liest nur), destructiveHint (es kann Daten überschreiben oder entfernen), idempotentHint (eine Wiederholung hat keine zusätzliche Wirkung) und openWorldHint (es erreicht Menschen oder Systeme außerhalb von SmartChat).

Recht und Wirkung sind zwei verschiedene Dinge. Ein Recht sagt, welche Aufrufe ein Schlüssel machen darf. Eine Wirkung sagt, was ein Aufruf tut. Der REST-Aufruf create_contact_export braucht das Recht contacts:read, weil er deine Kontakte liest. Trotzdem erzeugt er eine neue Datei mit Namen, Telefonnummern und E-Mail-Adressen. Darum markiert MCP das Werkzeug export_contacts als Schreib-Werkzeug (readOnlyHint ist false). Ein Schlüssel mit nur der Stufe Read kann also einen Export starten. Siehe Rechte.