Documentation
Setup guides for getting the most out of Cogny Cloud, integration guides, MCP and API references, and technical architecture documentation. Press / to search.
Getting Started & Setup
How to set up Cogny Cloud for success: what to connect, what to tell the agent, and how to run the weekly loop
01
Set Up Cogny Cloud for Success
The complete guide to getting value from Cogny Cloud: what Cogny is, the one-hour setup, what to expect in weeks one to four, and the weekly routine that makes it compound.
02
Before Your Onboarding: Checklist and Wizard
What to decide and gather before the Cloud onboarding call, who should attend, and what the Cloud setup wizard does in its two steps.
03
Connect Your Data Sources
Which integrations to connect first and why, how OAuth and API-key connections work, the GA4 and Search Console links into BigQuery, tool permissions, and the traps that cost a week.
04
Context and Growth Strategy
The context layers the agent reads before every report and ticket: the generated industry, company and competitor documents, the growth strategy, the context tree, and what to put where.
05
Core Metrics
Define the two to five numbers you run the business on, so every report and ticket is judged against them, and unlock the Core Metrics Drivers report.
06
Reports and Templates
How scheduled reports work, which templates to enable first for your kind of business, cadence and adaptive scheduling, custom instructions, email delivery, and what reports cost.
07
Tickets and Approvals
How the ticket board works, the three decisions on every ticket, why the first twenty deserve real review, how feedback teaches the agent, and how to turn on auto-execution safely.
08
Automations and Content Loops
Beyond weekly reports: Autonomous Operator jobs that act through one granted tool, Content from data loops that turn a source into published pieces, and Scripts for deterministic sync work.
09
Coding Agent, GitHub and Cogny Sites
Connect your repository so tickets ship as pull requests with preview deployments and visual proof, what to expect from the coding agent, and how to handle sites on a locked CMS.
10
Use Cogny from Your Own Agent
Connect Claude, ChatGPT, Codex, Cursor, Lovable or the Cogny CLI to your workspace over MCP, when to use your own agent instead of the in-app chat, and what it costs.
11
Credits and Plans
What the plans include, what consumes credits and what does not, rough costs per action, what happens at zero, and how to keep a Cloud workspace inside its monthly allowance.
12
Team, Governance and Privacy
Roles and invitations, the weekly operating cadence that keeps the loop running, human-in-the-loop support, Cogny Shield for personal data, audit trails, and workspace deletion.
13
Cogny Cloud FAQ
The questions customers ask most before and after setting up Cogny Cloud, answered plainly: trials, credits, what it does and does not do, time required, CMS support, privacy and results.
Connecting Integrations
The integration catalog, per-platform setup guides, and connectors that need extra steps
01
Integration Catalog and Setup Guides
Everything Cogny connects to, grouped by category, with the setup guide for each platform and the connectors that need extra steps.
02
Connect Discord to Cogny — bot setup, intents, and invite URL
End-to-end Discord MCP setup: create the application, copy the token, install the bot with the right scope and permissions, and enable the two privileged intents the read tools need.
Features
How the product works under the hood
How Growth Tickets Work
How Cogny turns report insights into prioritised, executable tickets: what the ticket agent reads, how it scores and de-duplicates, how execution and analysis close the loop, and what always stays with a human.
How AI Reports Work
How a Cogny report is produced: the template and context that shape it, the bounded analysis loop over your warehouse and integrations, the data-quality checks, the output structure, scheduling and delivery.
How ICP Analysis Works
How Cogny builds, validates and uses your ideal customer profile: generated from context and real buyer data, editable, exported as platform targeting, and checked against actual conversions by the Audience Intelligence report.
MCP & Agents
Use Cogny from Claude, ChatGPT, Cursor or any MCP client
API
REST API references and authentication guides
Growth Tickets API Reference
Complete API reference for accessing and managing AI-generated growth tickets, including filtering, prioritization, and status management.
Report Builder API Reference
Comprehensive API reference for generating AI-powered growth reports programmatically, including streaming responses and advanced customization options.
Cogny API Overview and Authentication
Complete guide to authenticating with the Cogny API and understanding its core capabilities for programmatic access to growth analytics.
Platform References
Reference material for the platforms Cogny reads from: GA4, Google Ads, GTM, Meta, schema.org, UTMs and more
Conversion Tracking Debugger Reference
Complete debugging guide for conversion tracking across GTM, GA4, Google Ads, and Meta Pixel. Covers discrepancy diagnosis, BigQuery validation queries, Consent Mode v2, Enhanced Conversions, server-side tagging, and step-by-step troubleshooting flowcharts.
Core Web Vitals Reference
Complete technical reference for Core Web Vitals (LCP, INP, CLS): thresholds, common causes, fixes, measurement tools, CrUX BigQuery queries, web-vitals library usage, and SEO impact.
GA4 BigQuery Export Schema Reference
Complete reference guide to the Google Analytics 4 BigQuery export schema, including table structure, nested fields, common queries, and data processing best practices.
GA4 Event Implementation Reference
Complete reference for implementing Google Analytics 4 events: automatically collected, enhanced measurement, recommended, and custom events with exact parameter lists, code examples, and validation techniques.
Google Ads Query Language (GAQL) Reference
Complete GAQL reference covering syntax, resource types, fields, operators, date macros, and ready-to-use query patterns for campaign performance, search terms, Quality Score, geographic targeting, and more.
Google Ads Scripts Reference
Complete reference guide to Google Ads Scripts: JavaScript automation within Google Ads, AdsApp object model, selectors and iterators, GAQL queries, common script patterns with working code, Google Sheets integration, MCC scripts, and best practices.
GTM Event Tracking & Setup Reference
Complete reference guide to Google Tag Manager event tracking, including dataLayer fundamentals, trigger and variable types, GA4 tag configuration, debug mode, and implementation best practices.
Meta Conversions API (CAPI) Setup Reference
Complete technical reference for Meta Conversions API: architecture, event types, customer information parameters, implementation methods, deduplication, testing, and Aggregated Event Measurement.
Schema.org Structured Data Reference
Complete reference for Schema.org structured data markup: JSON-LD examples for every major schema type, rich results eligibility, testing tools, and implementation patterns for static sites, Next.js, React, and WordPress.
UTM Parameter Strategy & Builder Reference
Complete guide to UTM parameter strategy, naming conventions, GA4 channel grouping rules, auto-tagging behavior, common mistakes, and BigQuery validation queries for marketing attribution.
Security
Security, privacy, and compliance documentation
Trust
AI transparency, literacy and how to read what the agent says