Get started
Install Synter in Claude
The recommended path is the Synter plugin in Claude Cowork. It installs the real workflows and configures the hosted MCP automatically.
ScopeThese guides describe the existing Synter Media connector for authorized customer workspaces. The Synter.dev private-alpha intake and governed sandbox described on the homepage are a separate preview surface.
Claude Cowork
- Open the Cowork tab, then open Customize.
- Open the Plugins tab. In Personal plugins, click +, choose Add marketplace, then Add from a repository.
- Add
https://github.com/Synter-Media-AI/plugin. If your team instead gives you a reviewed custom plugin ZIP, Claude Desktop and Cowork also support uploading that trusted custom plugin file. - Find Synter in the marketplace and click Install.
- When prompted, configure your Synter API key. Create one at syntermedia.ai/developer if needed. Enter it in the sensitive plugin configuration field, not in the conversation.
- Start a new task and run
/synter:quickstart. Confirm the returned organization and account IDs before requesting changes.
Organization policy may applyTeam and Enterprise owners can restrict plugins and connectors, distribute organization-managed plugins, or make a plugin auto-installed or required. If controls are unavailable, contact your Claude organization owner.
Claude Code
Run the exact commands from the canonical plugin README:
/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synterWhen enabling the plugin, configure the Synter API key in the plugin prompt. Then run /synter:quickstart. If you leave the key blank, quickstart can guide onboarding; configure the resulting key in plugin settings rather than sending it in chat.
Direct MCP fallback
This option is only for MCP clients that support custom HTTP headers. Use this exact configuration:
{
"mcpServers": {
"synter": {
"type": "http",
"url": "https://mcp.syntermedia.ai",
"headers": { "X-Synter-Key": "syn_your_api_key_here" }
}
}
}Cowork requires the plugin pathStandalone Claude Custom Connector UI does not expose arbitrary HTTP headers, so it cannot currently send the required
X-Synter-Key. Cowork users should install the Synter plugin above. A standalone Cowork custom connector would require Synter to support OAuth first.Never paste secrets into a conversation prompt. Direct MCP setup does not add the plugin's commands, skills, agents, hook, or output style.
First safe check
- Run
/synter:quickstart. - List connected accounts and confirm the intended organization and exact platform account IDs.
- Start with a read-only report using
/synter:report. - Before any write, verify budget, tracking, destination, and exact authority.