Zum Inhalt springen

Intentos mit MCP aus deinem KI Assistenten nutzen

Verbinde den Intentos MCP Server mit Claude und anderen MCP Clients, um Creator zu recherchieren, ihre Videos zu analysieren und zu remixen, Bilder zu erzeugen und Intentos Skills aus deinem Assistenten zu laden. Die technische Dokumentation ist auf Englisch.

MCP Server

The Model Context Protocol server lets AI assistants, Claude Desktop, Claude Code, Cursor, use IntentOS through natural language. Ask an assistant to “generate a 16:9 image of…” or “how many credits do I have left?” and it calls your account.

Research tools (scope research): research_list_creators, research_add_creator, research_list_videos, research_analyze_video, research_remix_video, research_final_script, research_vault_list, research_vault_save, research_usage.

Loop tools (scope loop), the same functions as the strategist chat in the app: loop_create_board, loop_get_board, loop_add_node, loop_connect_nodes, loop_run_node, loop_propose_directions, loop_approve_direction, loop_run_gate, loop_list_top_picks, loop_approve_picks, loop_search_assets, loop_search_captured_ads, loop_get_audit, loop_get_usage. Steps that cost model calls first return the cost; call again with confirm: true once the person agreed. They also run over HTTP: POST /api/v1/loop with { tool, input }.

Other tools: generate_video, upscale_image, remove_background, get_credits, list_generations, search_skills, get_skill, meta_ads_account, meta_ads_list_campaigns, meta_ads_create_campaign (always created paused).

MCP: setup

Add this to your MCP client config (Claude Desktop claude_desktop_config.json, a project .mcp.json, or Cursor ~/.cursor/mcp.json):

json — json
{
"mcpServers": {
"intentos": {
"command": "npx",
"args": ["-y", "@spycy/mcp"],
"env": { "INTENTOS_API_KEY": "sk_live_your_key" }
}
}
}

Claude Code: claude mcp add intentos --env INTENTOS_API_KEY=sk_live_your_key -- npx -y @spycy/mcp

Give the key the scopes it needs when you create it: research, studio, media, leads, skills or all. A tool called with a key that lacks its scope returns an error naming the missing scope.

Restart the client, then try: “List my tracked creators and break down the biggest outlier from this week.”

MCP: skills

The server exposes search_skills and get_skill. Ask your assistant to “find an Intentos skill for carousel posts” or “use the Intentos skill product-ad-set”: it loads the skill's instructions and follows them with the generation tools.