By Ira Bodnar, Ryze AI · Updated
Quick answer
To connect Claude to LinkedIn Ads, connect LinkedIn Ads in a Ryze AI workspace with the LinkedIn login that has access to your ad accounts in Campaign Manager, then add https://connector.get-ryze.ai/mcp as a custom connector in Claude and start a new chat.
- In Ryze AI open Integrations, find LinkedIn Ads and click Connect
- Sign in with your Campaign Manager login and approve every permission
- In Claude open Customize, Connectors, Add custom connector and paste the URL
- Click Connect, pick the workspace, click Allow connection, open a new chat
Before you start
- A Claude account. Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans. Free accounts are limited to one custom connector. On Team plans only Owners and Primary Owners can add a custom connector, and on Enterprise plans Owners, Primary Owners and people with a custom role that includes Manage access to Libraries can add one. Members then connect to it individually.
- A LinkedIn login with access to the ad account. You sign in to LinkedIn with the login that can open your ad accounts in Campaign Manager. Ryze AI sees every ad account that login can reach. LinkedIn only lets the Viewer role read data, so a login that must create or change campaigns needs a role that can edit, such as Campaign Manager.
- A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial, and Agency is $279 per month for agencies. Connecting the connector is free, but the LinkedIn Ads tools need an active plan or trial.
How to connect Claude to LinkedIn Ads in claude.ai
Three steps happen in Ryze AI and LinkedIn, three in Claude. Every user pastes the same connector URL.
Open Integrations in Ryze AI
Create a Ryze AI account or sign in, then open Integrations in the left sidebar. Find LinkedIn Ads with the Advertising filter or the search box and click Connect.
Sign in to LinkedIn and approve the permissions
Sign in with the LinkedIn login that has access to your ad accounts in Campaign Manager. LinkedIn lists the access Ryze AI asks for. Approve every permission it asks for, because LinkedIn does not let you accept only some of them.
Check the card shows Connected
Back in Ryze AI the LinkedIn Ads card shows Connected. There is no ad account to pick, because Ryze AI sees every ad account that login can reach. Optionally click View to choose Agent default accounts or to add one more LinkedIn login.
Add the custom connector in Claude
In claude.ai open Customize, then Connectors (claude.ai/customize/connectors). Click + Add, choose Add custom connector, enter the name Ryze AI and the URL https://connector.get-ryze.ai/mcp, then click Continue. On the authentication screen keep an OAuth sign-in option and do not choose No sign in, then click Add.
Click Connect and allow the workspace
Click Connect on the Ryze AI connector. On the Ryze AI page Connect your data sources to AI, sign in or sign up, choose the workspaces Claude can access (up to 20 per connection) and click Allow connection.
Open a new chat and ask your first question
Start a new chat. Connectors can be turned on or off per conversation from the + button, then Connectors. Ask: List my LinkedIn ad accounts with their currency and status.
The Ryze AI help center entry for LinkedIn Ads covers the LinkedIn side of the connection, and the Claude connector FAQ covers the connection errors.
Claude Desktop, Team and Enterprise
Anthropic says Claude connects to a remote MCP server from its cloud, not from your device, on every Claude client including Desktop, Cowork and the mobile apps. The Customize, Connectors steps above are the same in Claude Desktop on an individual plan, and a connector you add on claude.ai is available there too.
For Team and Enterprise, an owner adds Ryze AI under Organization settings, Connectors: click Add, hover over Custom, select Web, enter the name Ryze AI and the URL, and under Authentication choose Sign in now or Sign in when needed. Each member then opens Customize, Connectors, finds Ryze AI (usually labeled Custom), clicks Connect and picks workspaces. The Ryze AI listing in the Claude Directory also exists. It carries Anthropic's Community label, which means automated review and no verification by Anthropic.
Claude Code
Claude Code registers MCP servers from the shell. This command adds the connector:
claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userRun /mcp inside Claude Code, select ryze and authenticate, or run claude mcp login ryze in the shell (add --no-browser to print the URL, for example over SSH). Sign in on the Ryze AI page, choose workspaces and click Allow connection. The default scope is local; --scope user makes the server available in all your projects and --scope project writes a .mcp.json for your team. Check the status with claude mcp get ryze.
Claude Code needs a Pro, Max, Ultra, Team, Enterprise or Console account, because the free claude.ai plan does not include it. For scripts, Ryze AI also issues API keys (Workspace Settings, Profile, API keys) that go in an Authorization Bearer header on the /mcp endpoint. Claude Code warns when a tool result passes 10,000 tokens and caps output at 25,000 tokens by default, which matters for a wide LinkedIn report.
ChatGPT and Cursor
Other MCP clients take the same URL. LinkedIn stays connected in Ryze AI, so the LinkedIn sign-in is not repeated.
ChatGPT
OpenAI lists custom MCP server connections for ChatGPT Business and Enterprise/Edu on the web, and read and fetch permissions only for Pro. On Business an admin or owner has to create and publish the plugin. Go to Plugins, select the plus button, then Add custom MCP server, enter the name Ryze AI and the URL, choose OAuth, and complete the Ryze AI sign-in.
Cursor
Add the server to .cursor/mcp.json (one project) or ~/.cursor/mcp.json (all projects), then complete the Ryze AI sign-in when Cursor asks.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }LinkedIn permissions, scopes and roles
The LinkedIn side is a standard LinkedIn OAuth sign-in. Three things decide what Claude can see and change.
- Who can connect
- Any LinkedIn member who can open the ad account in Campaign Manager. LinkedIn ties API access to the member's ad account role, so the login you use sets the ceiling. Ryze AI does not ask you to pick an ad account.
- Which accounts
- One login reaches every ad account it can access. Agent default accounts sets which ad accounts the agent works with first, and the others stay reachable by naming them in chat. Several LinkedIn logins can sit in one workspace through View, Add one more account.
- All permissions at once
- LinkedIn states that a member must accept all permissions an app requests, not a subset. Ryze AI asks for the eight scopes in the table below, so a login that does not want to grant them should not be connected.
Scopes Ryze AI requests
Ryze AI's LinkedIn sign-in requests these scopes. The right column is LinkedIn's own definition from its Marketing API documentation. The consent screen is the source of truth for the exact list.
| Scope | LinkedIn's definition |
|---|---|
| r_ads | Read the member's ad accounts. LinkedIn restricts it to accounts where the member has Account Billing Admin, Account Manager, Campaign Manager, Creative Manager or Viewer. |
| rw_ads | Manage and read the member's ad accounts. LinkedIn restricts it to Account Billing Admin, Account Manager, Campaign Manager and Creative Manager. |
| r_ads_reporting | Retrieve reporting for the member's ad accounts. |
| r_organization_social | Retrieve an organization's posts, comments and likes. |
| w_organization_social | Post, comment and like on behalf of an organization. The six Ryze AI LinkedIn Ads tools below do not include a posting tool. |
| openid, profile, email | Standard sign-in scopes that identify the LinkedIn member. |
Ad account roles
LinkedIn assigns roles per ad account in Campaign Manager. The role decides whether a read or a write succeeds.
| Role | What LinkedIn says it can do |
|---|---|
| Viewer | View campaign data and reports. Cannot create or edit campaigns or ads. |
| Creative Manager | Create, edit and view campaign data and reports, and create and edit ads. |
| Campaign Manager | View campaign data and reports, and create and edit campaigns and ads. |
| Account Manager | Everything Campaign Manager can do, plus editing account data and managing user access. |
| Account Billing Admin | Everything Account Manager can do, plus billing data. LinkedIn recommends one Billing Admin per account. |
Sources: LinkedIn's Marketing API key concepts, increasing access and the Campaign Manager user roles help page. Checked November 9, 2026.
Removing access
To remove access, click View on the LinkedIn Ads card in Ryze AI to manage the connected login. In Claude, open Customize, Connectors, Ryze AI and click Disconnect. Anthropic notes that editing a custom connector means removing it and adding it again.
What Claude can do in LinkedIn Ads
The Ryze AI connector exposes six LinkedIn Ads tools. Each runs as the LinkedIn login you connected.
| Tool | Type | What it does |
|---|---|---|
| linkedin_ads__listAccounts | Read | Lists every LinkedIn ad account the connected login can access, with id, name, currency and status. |
| linkedin_ads__read | Read | Reads any LinkedIn Marketing API resource, such as campaigns, campaign groups, creatives, targeting and lead forms. |
| linkedin_ads__report | Read | Runs a LinkedIn adAnalytics report by campaign, creative, account, campaign group, company, job title or country. |
| linkedin_ads__write | Write | Creates or updates a LinkedIn Ads resource, for example a campaign, creative or lead form, or pauses a campaign. |
| linkedin_ads__uploadImageFromUrl | Write | Uploads an image from a URL as a LinkedIn image asset for use in creatives. Images only, no video files. |
| linkedin_ads__delete | Delete | Deletes a LinkedIn Ads resource. Only draft campaigns can be hard-deleted; a live campaign is set to pending deletion through the write tool instead. |
In Claude, open Customize, Connectors, Ryze AI, Tool permissions and set the write and delete tools to Needs approval. Claude then asks before it pauses a campaign, edits a budget or deletes a draft. Without that setting, Claude can run those tools when you ask. In Research mode, Anthropic notes that Claude can call connector tools without further approval.
First 3 prompts to run
LinkedIn's adAnalytics does not return CTR, CPC or a generic conversions field directly. Claude works them out from clicks, impressions, cost and the conversion fields, so ask for the formula if you want to see it. The prompts below describe what comes back instead of showing numbers.
1. Campaign report for the last 30 days
List my LinkedIn ad accounts. For the account named in the first row, run a report by campaign for the last 30 days with impressions, clicks, spend, website conversions and leads, then work out CTR and cost per lead for each campaign.
Tools used: linkedin_ads__listAccounts, linkedin_ads__report
What comes back: A table with one row per campaign and the metrics you asked for, plus the CTR and cost per lead Claude calculated from the raw fields.
2. Who clicks: job title, company and country
For my main LinkedIn ad account, run reports for the last 30 days broken down by job title, by company and by country. Show clicks and spend for each, and tell me which job titles take spend without leads.
Tools used: linkedin_ads__report
What comes back: Three ranked breakdowns for the period, with the job titles that have spend and no leads called out in a separate list.
3. Pause a campaign, with approval
Show the campaigns in my LinkedIn campaign group named Q4 pipeline with their status and daily budget. Then pause the campaign with the highest spend and no leads, and confirm its new status.
Tools used: linkedin_ads__read, linkedin_ads__report, linkedin_ads__write
What comes back: The campaign list with status and budget, the campaign Claude picked and why, and the status read back after the pause. With write tools on Needs approval, Claude stops and asks before the change.
Every answer comes from your own LinkedIn account. A login without an editing role on the ad account can read but cannot change campaigns, so the third prompt would fail there with a LinkedIn error.
Ryze AI vs building on the LinkedIn Marketing API
As of November 9, 2026, LinkedIn's Marketing API documentation describes a REST API and does not describe an MCP server or Claude connector for Campaign Manager. We did not review community-built servers. The options below are the ones LinkedIn documents plus the Ryze AI connector.
| Option | Setup | LinkedIn Ads coverage | Works in |
|---|---|---|---|
| Ryze AI connector | LinkedIn sign-in inside Ryze AI, then one custom connector URL in Claude | Six tools: list accounts, read resources, adAnalytics reports, write, image upload from a URL and delete of draft campaigns | claude.ai, Claude Desktop, Claude Code, ChatGPT, Cursor |
| Your own app on the LinkedIn Marketing API | Apply for Advertising API access in the LinkedIn developer portal, request OAuth scopes such as r_ads, rw_ads and r_ads_reporting, and write the API calls yourself | The whole Advertising API. The Development tier reads any ad account you administer and edits up to 5 ad accounts; the Standard tier needs a separate support request and allows unlimited edits | Anything you build |
| Campaign Manager export or API reports by hand | Open Campaign Manager and export performance, or call the adAnalytics API | Reports only, with no write step through Claude | Spreadsheets or your own scripts |
If you need a custom integration with LinkedIn's full Advertising API, building on it yourself gives full control but means applying for access and maintaining the code. The Ryze AI connector gives Claude a fixed set of six tools after one sign-in. LinkedIn also limits API calls per application and per member per day, resets them at midnight UTC and answers 429 when a limit is hit. LinkedIn does not publish the standard limits for each endpoint.
Sources: LinkedIn access tiers, LinkedIn API rate limiting, Ryze AI help center, ad platforms. Checked November 9, 2026.
LinkedIn Ads errors and fixes
- The LinkedIn tools do not appear in Claude
- Claude keeps the Ryze AI tool list from the moment the connector is added. If you connected LinkedIn Ads afterwards, remove the Ryze AI connector under Customize, Connectors, add it again and start a new chat.
- Claude lists no ad accounts
- Ryze AI only sees the ad accounts the connected LinkedIn login can access. Check that the login has a role on the account in Campaign Manager, or reconnect with the right login.
- A write fails with a permission error
- LinkedIn lets the Viewer role read only. Ask an Account Manager to give the login Campaign Manager or higher under Manage access in Campaign Manager.
- Claude cannot delete a live campaign
- Only draft campaigns can be hard-deleted. For a live campaign the write tool sets it to pending deletion, so ask Claude to do that instead.
- A video upload is refused
- The upload tool handles images only. Add video creatives in Campaign Manager.
- CTR or CPC is missing from a report
- adAnalytics returns clicks, impressions, cost and conversion fields. Ask Claude to calculate CTR and CPC from them.
- LinkedIn returns 429
- LinkedIn rate limits API calls per application and per member in a 24 hour window that resets at midnight UTC. Wait for the reset or ask for narrower reports.
- The wrong LinkedIn login is connected
- Click View on the LinkedIn Ads card in Ryze AI, use Add one more account to connect the right login and mark it as primary.
- Claude says a subscription is required
- The LinkedIn Ads tools need an active Ryze AI plan or free trial. Start the trial, then retry in a new chat.
Frequently asked questions
How do I connect Claude to LinkedIn Ads?
Connect LinkedIn Ads in a Ryze AI workspace: open Integrations, click Connect on LinkedIn Ads, sign in with your Campaign Manager login and approve every permission. Then in claude.ai open Customize, Connectors, Add custom connector, enter https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and start a new chat.
Does LinkedIn have its own Claude connector or MCP server?
Not that we found. As of November 9, 2026 LinkedIn's Marketing API documentation describes a REST API, and it does not describe an MCP server or a Claude connector for Campaign Manager. Community servers may exist, and we did not review them.
Which way of connecting Claude to LinkedIn Ads should I use?
Ryze AI is the best way to connect Claude to LinkedIn Ads for report and campaign tasks from one sign-in, but it needs a Ryze AI plan or trial and offers six fixed tools. Building on LinkedIn's Advertising API gives full control, at the price of applying for access and writing code.
What LinkedIn role do I need?
A login that can open the ad account in Campaign Manager. The Viewer role can read campaign data and reports only. To create or edit campaigns, LinkedIn requires Creative Manager, Campaign Manager, Account Manager or Account Billing Admin.
Which Claude plan do I need?
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise. Free allows one custom connector. On Team an Owner or Primary Owner adds it, and each member then clicks Connect.
Can Claude pause or edit LinkedIn campaigns?
Yes. The write tool creates or updates campaign groups, campaigns, creatives and lead forms, for example to pause a campaign or change its budget. To make Claude ask first, set write and delete tools to Needs approval in Customize, Connectors, Ryze AI.
Can Claude delete LinkedIn campaigns?
Only draft campaigns can be hard-deleted. Live campaigns are set to pending deletion through the write tool instead.
What reports can Claude run?
The report tool runs LinkedIn adAnalytics reports for impressions, clicks, spend, website conversions, leads and engagement, broken down by campaign, creative, account, campaign group, company, job title or country. CTR and CPC are calculated from the raw fields.
Can I connect more than one LinkedIn account?
Yes. Click View on the LinkedIn Ads card and choose Add one more account. A star marks the primary login. One login reaches every ad account it can access, and Agent default accounts sets which accounts the agent works with first. Name another account in chat to use it.
Does this work in Claude Desktop and Claude Code?
Yes. Claude connects from Anthropic's cloud on every client, so a connector added in claude.ai is available in Desktop. In Claude Code run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then /mcp to sign in. Claude Code needs a paid Claude plan or Console account.
How much does it cost to connect Claude to LinkedIn Ads?
Connecting the connector is free, but the LinkedIn Ads tools need an active Ryze AI plan or trial. Paid Ads is $89 per month with a 7-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year.
How do I disconnect LinkedIn Ads from Claude?
Remove the Ryze AI connector in Claude under Customize, Connectors, or click View on the LinkedIn Ads card in Ryze AI to manage the connected login.