MCP Configuration
Configure your AI client to connect to Synter's MCP server
Prerequisites
- A Synter account with connected ad platforms
- An API key from the Developer Portal
- Claude Desktop, Cursor, or Windsurf installed
No account yet? Onboard from your MCP client
You can create a Synter account without leaving your AI client. The MCP server exposes two onboarding tools that work before you have an API key, and neither costs credits:
Start onboarding
Ask your AI client to call the tool with your work email. This creates an account, emails you a magic link, and returns a session token.
synter_onboarding_start(email="you@company.com")Verify your email
Open the magic link from the email to verify your address.
Check onboarding status
Poll with the session token returned by the first call until it reports your account is ready.
synter_onboarding_status(session_token="...")Add your API key
Once ready, copy your API key from the Developer Portal and add it to your client configuration below, then restart the client.
Client configuration
// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"synter-ads": {
"command": "mcp-proxy",
"args": [
"--transport", "streamablehttp",
"--headers", "X-Synter-Key", "syn_your_api_key_here",
"https://mcp.syntermedia.ai"
]
}
}
}Using environment variables
Instead of hardcoding your API key, use an environment variable:
# Add to your shell profile (~/.zshrc or ~/.bashrc)
export SYNTER_API_KEY="syn_your_api_key_here"Verify connection
After configuring, restart your AI client and ask:
Troubleshooting
"Invalid API key" error
Verify your API key is correct and hasn't been revoked
Connection timeout
Check your internet connection and verify the endpoint is reachable
Tools not appearing
Restart your AI client completely after saving the config file