AI assistants

Use Zipe inside your AI assistant

Connect Claude, ChatGPT or another AI client to your workspaces, with the permissions you choose and one workspace at a time.

Server address

https://mcp.zipe.app/mcp

Before connecting

  • AI agent access starts off in every workspace. An owner or admin turns it on in Settings › AI agents.
  • To connect, you need to be a member, admin or owner in at least one workspace.
  • One connection reaches all your workspaces, including later ones. Where you are a viewer, the assistant only reads.
  • Each tool acts on a single workspace, chosen by name in every request.

How to connect

Claude

Free, Pro or Max

Who does it: You add the connector yourself.

  1. Open Customize › Connectors at claude.ai/customize/connectors.
  2. Click Add custom connector and name it Zipe.
  3. Paste the address https://mcp.zipe.app/mcp.
  4. When asked about the OAuth client, keep Use Claude's published identity.
  5. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

On the Free plan, Claude accepts a single custom connector.

Team or Enterprise

Who does it: Only the Owner of the Claude organization adds the connector; each member then just clicks Connect.

  1. The Owner opens Organization settings › Connectors and adds a custom connector named Zipe.
  2. Paste the address https://mcp.zipe.app/mcp.
  3. Each member opens Customize › Connectors, finds Zipe and clicks Connect.
  4. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

On these plans a member cannot add the connector alone.

Claude Code

Terminal

Who does it: You, on your own computer.

claude mcp add --transport http zipe https://mcp.zipe.app/mcp
  1. Run the command above in the terminal.
  2. Inside Claude Code, type /mcp, pick zipe and authorize in the browser.
  3. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

Claude Code does not ask for a new permission in the middle of a call. To authorize what you will use up front, see the For developers block.

For developers

For Claude Code to ask for the permissions you want on the first authorization, add Zipe with oauth.scopes. The line below asks for Read the workspace, Read Conversations, Reply in Conversations, Read Social Listening, Operate Social Listening, Create and publish content, Manage automations, Adjust the Brain, Manage competitors and My preferences. Paid features and Administration are left out; add them if you need them.

claude mcp add-json zipe '{"type":"http","url":"https://mcp.zipe.app/mcp","oauth":{"scopes":"zipe:read zipe:conversations:read zipe:conversations:write zipe:listening:read zipe:listening:write zipe:content:write zipe:automations:write zipe:brain:write zipe:insights:write zipe:self:write"}}'

If a tool asks for a permission that is not on the list, add it to oauth.scopes and authorize again in /mcp.

ChatGPT

Plus or Pro (web)

Who does it: You create the plugin yourself.

  1. Open chatgpt.com/plugins, click + and choose Add custom MCP server.
  2. Name it Zipe.
  3. Paste the address https://mcp.zipe.app/mcp.
  4. Under Authentication, choose OAuth.
  5. Accept the risk notice and choose Create as a plugin.
  6. Open the plugin and install it with +.
  7. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.
  8. In a conversation on the Work tab, call Zipe with @Zipe.

Business, Enterprise or Edu

Who does it: Only an admin or owner of the ChatGPT workspace creates and publishes it; that workspace access control decides who uses it.

  1. The admin opens chatgpt.com/plugins, clicks + and chooses Add custom MCP server.
  2. Paste the address https://mcp.zipe.app/mcp.
  3. The admin chooses OAuth under Authentication, accepts the risk notice and chooses Create as a plugin.
  4. The admin publishes the plugin to the people or groups who will use it, and each person installs it with +.
  5. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

In a Business or Enterprise workspace, the ChatGPT administrator policy may block custom MCP servers.

If the ChatGPT admin leaves the app writes off, only the Zipe reads show up. To allow invites, requests and the other writes, the admin opens Workspace settings › Apps › Manage actions and enables the Zipe actions.

ChatGPT Company Knowledge only looks things up: no Zipe write runs through it. To invite, change settings or create a request, call Zipe in a conversation.

VS Code

Terminal

Who does it: You, on your own computer.

code --add-mcp '{"name":"zipe","type":"http","url":"https://mcp.zipe.app/mcp"}'
  1. Run the command above in the terminal.
  2. In VS Code, start the zipe server and authorize in the browser when asked.
  3. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

Codex

Terminal

Who does it: You, on your own computer.

codex mcp add zipe --url https://mcp.zipe.app/mcp
codex mcp login zipe
  1. Run the two commands above, one after the other.
  2. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

Without the login, Codex connects unauthenticated and Zipe refuses. After revoking the connection, run the login again.

Authorization returns to your own computer. A remote callback address, such as one from a cloud environment, is not accepted.

Antigravity

Terminal

Who does it: You, on your own computer.

agy mcp add zipe https://mcp.zipe.app/mcp
  1. Run the command above in the terminal.
  2. Authorize in the browser when Antigravity asks.
  3. Sign in to Zipe at app.zipe.app, check the client name and tick the permissions you want.

Try asking

Always name the workspace. The assistant picks the tools on its own.

  • List my Zipe workspaces and tell me my role in Padaria Lumen.
  • In Padaria Lumen, summarize the reach and engagement of the connected accounts over the last 30 days.
  • Which were the 5 posts with the most engagement in Padaria Lumen this month, and what do they share?
  • What is scheduled on the Padaria Lumen calendar for next week?
  • Create a draft Instagram post for Padaria Lumen about sourdough bread, in the brand voice.
  • In Padaria Lumen, which watched competitors grew the most in followers this month?
  • Show this week's unanswered comments in Padaria Lumen, grouped by topic.

What the assistant does

99 tools in 11 modules: 43 read tools, 5 paid read tools, 20 direct write tools and 31 tools that ask for approval in the app.

Analytics

  • Workspace overview

    Read

    Summarizes the workspace: connected accounts, followers, recent reach and engagement.

    Permission: Read the workspace

  • List posts

    Read

    Lists the posts of the connected accounts, filtered by network, period and format, with the metrics of each one.

    Permission: Read the workspace

  • Get a post

    Read

    Opens a post with its caption, its metrics and how they changed day by day.

    Permission: Read the workspace

  • Account daily series

    Read

    Returns the daily series of a connected account: followers, reach and engagement.

    Permission: Read the workspace

  • Get the audience

    Read

    Shows the audience of a connected account: age, gender and location, when the network reports them.

    Permission: Read the workspace

  • Search the workspace

    Read

    Searches one workspace by text: posts, ideas, Brain facts and other items you can read.

    Permission: Read the workspace

  • Fetch an item

    Read

    Opens an item found by the search, with its full content.

    Permission: Read the workspace

  • Account health

    Read

    Shows the health of the connected accounts: connection, sync and what needs attention.

    Permission: Read the workspace

  • Media reading result

    Read

    Returns the result of an image, video or transcript reading that was already requested.

    Permission: Read the workspace

  • Read an image or video

    ReadPaid features

    Reads the image or video of a post and describes the hook, the scenes and the tone.

    Permission: Read the workspace, Paid features

  • Transcribe a video

    ReadPaid features

    Transcribes the speech of a video from a connected account or a watched competitor.

    Permission: Read the workspace, Paid features

For developers

Technical tool names, as the AI client shows them.

  • get_workspace_overview Workspace overview
  • list_posts List posts
  • get_post Get a post
  • get_account_series Account daily series
  • get_audience Get the audience
  • search Search the workspace
  • fetch Fetch an item
  • get_account_health Account health
  • get_media_result Media reading result
  • read_media Read an image or video
  • transcribe_video Transcribe a video
Calendar and Ideas

  • Get the content calendar

    Read

    Shows the Calendar: draft, scheduled, published and failed posts, by period.

    Permission: Read the workspace

  • List content ideas

    Read

    Lists the ideas of the Ideas board, with column, tags and owners.

    Permission: Read the workspace

  • Check copy

    Read

    Checks a text against the publishing rules of each network, such as the character and hashtag limits, before scheduling.

    Permission: Read the workspace

  • Create a post draft

    Direct

    Creates a post draft in the Calendar, with text, media and destination accounts.

    Permission: Create and publish content

  • Update a post draft

    Direct

    Edits a post draft that has not been scheduled yet.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

  • Cancel a scheduled post

    Direct

    Cancels the schedule of a post, which goes back to being a draft.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

  • Schedule a post

    Asks for approval in the app

    Asks to schedule a post for a date and time; someone in the workspace approves it in the app.

    Permission: Create and publish content

  • Retry a post

    Asks for approval in the app

    Asks to retry a post that failed to publish.

    Permission: Create and publish content

  • Edit a published post

    Asks for approval in the app

    Asks to edit the caption of a post already published, when the network allows it.

    Permission: Create and publish content

  • Delete a post

    Asks to delete a post from the Calendar; if it was already published, also from the social network.

    Permission: Create and publish content

    • draftAsks for approval in the app
    • publishedAsks for approval in the app

  • Create an idea

    Direct

    Creates an idea in the Ideas board.

    Permission: Create and publish content

  • Update an idea

    Direct

    Edits the title, text, tags or owners of an idea.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

  • Move ideas

    Direct

    Moves ideas between the board columns.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

  • Manage idea tags

    Creates and renames idea tags; deleting a tag asks for approval.

    Permission: Create and publish content

    • createDirectYour AI client may ask you to confirm first.
    • renameDirectYour AI client may ask you to confirm first.
    • deleteAsks for approval in the app

  • Update idea board properties

    Asks for approval in the app

    Asks to change the Ideas board properties, such as columns and fields.

    Permission: Create and publish content

  • Comment on an idea

    Direct

    Comments on an idea, in your name.

    Permission: Create and publish content

  • Create a post from an idea

    Direct

    Turns an idea into a post draft in the Calendar.

    Permission: Create and publish content

  • Create an approval link

    Asks for approval in the app

    Asks to create an idea approval link for someone outside Zipe.

    Permission: Create and publish content

  • Revoke an approval link

    Direct

    Revokes an idea approval link that is still open.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

  • Delete ideas

    Asks for approval in the app

    Asks to delete ideas from the board.

    Permission: Create and publish content

For developers

Technical tool names, as the AI client shows them.

  • get_content_calendar Get the content calendar
  • list_content_ideas List content ideas
  • check_copy Check copy
  • create_content_draft Create a post draft
  • update_content_draft Update a post draft
  • cancel_publication Cancel a scheduled post
  • schedule_publication Schedule a post
  • retry_publication Retry a post
  • edit_published_publication Edit a published post
  • delete_content Delete a post
  • create_idea Create an idea
  • update_idea Update an idea
  • move_ideas Move ideas
  • manage_idea_tags Manage idea tags
  • update_idea_board_properties Update idea board properties
  • comment_on_idea Comment on an idea
  • create_post_from_idea Create a post from an idea
  • create_idea_approval_link Create an approval link
  • revoke_idea_approval_link Revoke an approval link
  • delete_ideas Delete ideas
Conversations

  • List conversations

    Read

    Lists the direct message conversations of the connected accounts, filtered by account and unread.

    Permission: Read Conversations

  • Read a conversation

    Read

    Reads the messages of a conversation.

    Permission: Read Conversations

  • Conversation stats

    Read

    Shows conversation numbers: volume, unread and response time per period.

    Permission: Read Conversations

  • List comments

    Read

    Lists the comments received on the posts and ads of the connected accounts.

    Permission: Read Conversations

  • Read a comment thread

    Read

    Reads a comment with its replies.

    Permission: Read Conversations

  • List mentions

    Read

    Lists the mentions and tags of the connected accounts.

    Permission: Read Conversations

  • List reviews

    Read

    Lists the reviews received by the connected pages and places.

    Permission: Read Conversations

  • Mark a conversation as read

    Direct

    Marks a conversation as read in Zipe.

    Permission: Reply in Conversations

    Your AI client may ask you to confirm first.

  • Send a reply

    Asks for approval in the app

    Asks to reply to a conversation, a comment, a review or a mention; someone in the workspace approves it before it is sent.

    Permission: Reply in Conversations

  • Reply to a comment privately

    Asks for approval in the app

    Asks to reply to a comment by direct message to the person who commented.

    Permission: Reply in Conversations

  • Hide a comment

    Direct

    Hides a comment right away, without deleting it.

    Permission: Reply in Conversations

    Your AI client may ask you to confirm first.

  • Moderate a comment

    Asks for approval in the app

    Asks to show again, like, unlike or delete a comment.

    Permission: Reply in Conversations

For developers

Technical tool names, as the AI client shows them.

  • list_conversations List conversations
  • read_conversation Read a conversation
  • get_conversation_stats Conversation stats
  • list_comments List comments
  • read_comment_thread Read a comment thread
  • list_mentions List mentions
  • list_reviews List reviews
  • mark_conversation_read Mark a conversation as read
  • send_reply Send a reply
  • private_reply_to_comment Reply to a comment privately
  • hide_comment Hide a comment
  • moderate_comment Moderate a comment
Insights

  • Competitor panel

    Read

    Shows the panel of watched competitors: followers, frequency, engagement and formats.

    Permission: Read the workspace

  • List competitor content

    Read

    Lists posts of the watched competitors, filtered by account, period and format.

    Permission: Read the workspace

  • Analyze hashtags

    Read

    Analyzes the hashtags used in the posts of the connected accounts and of the watched competitors.

    Permission: Read the workspace

  • Look up a public account

    ReadPaid features

    Looks up a public profile by its handle, with followers and recent posts, without starting to watch it.

    Permission: Read the workspace, Paid features

  • Read competitor comments

    ReadPaid features

    Reads the comments of a watched competitor post, without storing or following them afterwards.

    Permission: Read the workspace, Paid features, Read Conversations

  • Discover posts by hashtag

    ReadPaid features

    Searches recent public posts of a hashtag outside the watched profiles.

    Permission: Read the workspace, Paid features

  • Watch an account

    Asks for approval in the appPaid features

    Asks to watch an account in Insights, which takes a place in the workspace competitor limit.

    Permission: Manage competitors, Paid features

  • Stop watching an account

    Asks for approval in the app

    Asks to stop watching an account in Insights.

    Permission: Manage competitors

For developers

Technical tool names, as the AI client shows them.

  • get_competitor_panel Competitor panel
  • list_competitor_content List competitor content
  • analyze_hashtags Analyze hashtags
  • look_up_social_account Look up a public account
  • read_competitor_comments Read competitor comments
  • discover_hashtag_posts Discover posts by hashtag
  • add_watched_account Watch an account
  • remove_watched_account Stop watching an account
Brain

  • Search the Brain

    Read

    Searches the Brain for facts about the brand identity, voice and editorial line, with the evidence of each one.

    Permission: Read the workspace

  • Get the brand context

    Read

    Returns the brand summary the Brain keeps: who it is, how it speaks and what it publishes about.

    Permission: Read the workspace

  • Read a Brain source document

    Read

    Reads a source the Brain used, such as a page of the website or the transcript of a brand video.

    Permission: Read the workspace

  • Record a Brain fact

    Confirms or corrects a Brain fact; declaring a new fact asks for approval.

    Permission: Adjust the Brain

    • confirmDirectYour AI client may ask you to confirm first.
    • correctDirectYour AI client may ask you to confirm first.
    • declare a new factAsks for approval in the app

  • Revise the strategy

    Asks for approval in the app

    Asks to revise the brand content strategy kept in the Brain.

    Permission: Adjust the Brain

For developers

Technical tool names, as the AI client shows them.

  • search_brain Search the Brain
  • get_brand_context Get the brand context
  • read_brain_source_document Read a Brain source document
  • record_brain_fact Record a Brain fact
  • revise_strategy Revise the strategy
Automations

  • List automations

    Read

    Lists the workspace automations, with the account, the trigger and whether they are active.

    Permission: Read the workspace

  • Get an automation

    Read

    Opens an automation with its trigger, keywords and the messages it sends.

    Permission: Read the workspace

  • Automation performance

    Read

    Shows how many messages an automation sent and how many people it reached per period.

    Permission: Read the workspace

  • List message templates

    Read

    Lists the message templates saved in the workspace.

    Permission: Read the workspace

  • Create an automation

    Direct

    Creates a comment reply automation, which starts paused.

    Permission: Manage automations

  • Update an automation

    Edits an automation; if it is active, the change asks for approval.

    Permission: Manage automations

    • paused automationDirectYour AI client may ask you to confirm first.
    • active automationAsks for approval in the app

  • Activate or pause an automation

    Pauses an automation right away; activating asks for approval.

    Permission: Manage automations

    • activateAsks for approval in the app
    • pauseDirectYour AI client may ask you to confirm first.

  • Delete an automation

    Asks for approval in the app

    Asks to delete an automation.

    Permission: Manage automations

  • Manage a message template

    Direct

    Creates, edits or deletes message templates of the workspace.

    Permission: Create and publish content

    Your AI client may ask you to confirm first.

For developers

Technical tool names, as the AI client shows them.

  • list_automations List automations
  • get_automation Get an automation
  • get_automation_performance Automation performance
  • list_message_templates List message templates
  • create_automation Create an automation
  • update_automation Update an automation
  • set_automation_active Activate or pause an automation
  • delete_automation Delete an automation
  • manage_message_template Manage a message template
Social Listening

  • List listening queries

    Read

    Lists the Social Listening queries and the state of each one.

    Permission: Read Social Listening

  • Get a listening query

    Read

    Opens a Social Listening query with its terms, networks and monthly usage.

    Permission: Read Social Listening

  • Query listening mentions

    Read

    Searches the mentions collected by a query, filtered by network, sentiment, theme and period.

    Permission: Read Social Listening

  • Get a listening mention

    Read

    Opens a mention with its text, author, engagement and sentiment reading.

    Permission: Read Social Listening

  • Listening insights

    Read

    Summarizes a query: volume per day, sentiment, themes and spikes.

    Permission: Read Social Listening

  • List saved mentions

    Read

    Lists the saved mentions of a query.

    Permission: Read Social Listening

  • Create a listening query

    Direct

    Creates a Social Listening query as a draft, which only collects after it is approved in the app.

    Permission: Operate Social Listening

  • Update a listening query

    Edits a query; as a draft it is direct, while collecting it asks for approval.

    Permission: Operate Social Listening

    • draft queryDirectYour AI client may ask you to confirm first.
    • collecting queryAsks for approval in the app

  • Decide on a listening suggestion

    Accepts or declines a configuration suggestion for a query.

    Permission: Operate Social Listening

    • draft queryDirectYour AI client may ask you to confirm first.
    • collecting queryAsks for approval in the app

  • Pause a listening query

    Direct

    Pauses the collection of a query.

    Permission: Operate Social Listening

    Your AI client may ask you to confirm first.

  • Set listening alert recipients

    Direct

    Chooses who in the workspace receives the alerts and the summary of a query.

    Permission: Operate Social Listening

    Your AI client may ask you to confirm first.

  • Manage saved mentions

    Direct

    Saves mentions or removes them from the saved list.

    Permission: Operate Social Listening

    Your AI client may ask you to confirm first.

  • Manage a listening community

    Creates or edits a community, a cut of a query described in natural language.

    Permission: Operate Social Listening

    • draft queryDirectYour AI client may ask you to confirm first.
    • collecting queryAsks for approval in the app

  • Request a listening sample

    Asks for approval in the appPaid features

    Asks for a sample of mentions to check the configuration of a query.

    Permission: Operate Social Listening, Paid features

  • Search places for Google reviews

    Asks for approval in the appPaid features

    Asks for a search of places to follow their reviews in a query.

    Permission: Operate Social Listening, Paid features

  • Request listening query activation

    Paid features

    Asks to start or resume the collection of a query.

    Permission: Operate Social Listening, Paid features

    • start collectingAsks for approval in the appPaid features
    • resume collectingAsks for approval in the appPaid features

  • Request listening query deletion

    Asks for approval in the app

    Asks to delete a query and its mentions.

    Permission: Operate Social Listening

  • Rate listening mentions

    Asks for approval in the app

    Asks to record relevance ratings on mentions, which teach the query.

    Permission: Operate Social Listening

For developers

Technical tool names, as the AI client shows them.

  • list_listening_queries List listening queries
  • get_listening_query Get a listening query
  • query_listening_mentions Query listening mentions
  • get_listening_mention Get a listening mention
  • listening_insights Listening insights
  • list_listening_saved List saved mentions
  • create_listening_query Create a listening query
  • update_listening_query Update a listening query
  • decide_listening_suggestion Decide on a listening suggestion
  • pause_listening_query Pause a listening query
  • set_listening_recipients Set listening alert recipients
  • manage_listening_saved Manage saved mentions
  • manage_listening_community Manage a listening community
  • request_listening_sample Request a listening sample
  • request_google_places_search Search places for Google reviews
  • request_listening_activation Request listening query activation
  • request_listening_delete Request listening query deletion
  • request_listening_feedback Rate listening mentions
AdsRead only

  • Get ads

    Read

    Reads the campaigns and ads of the ad accounts chosen in the workspace, with spend and results.

    Permission: Read the workspace

For developers

Technical tool names, as the AI client shows them.

  • get_ads Get ads
Agency

  • Set brand access

    Asks for approval in the app

    Asks to grant or remove the access of someone in the agency to a brand.

    Permission: Administration

For developers

Technical tool names, as the AI client shows them.

  • set_brand_access Set brand access
Workspace and team

  • List workspaces

    Read

    Lists the workspaces you can access, with the name, your role and the state of each one.

  • Get a request

    Read

    Shows a request made by the assistant: what it proposes, its state and the deadline to approve it.

    Permission: Read the workspace

  • List my requests

    Read

    Lists the requests you made through the assistant in a workspace and the state of each one.

    Permission: Read the workspace

  • List members

    Read

    Lists the workspace members and their roles.

    Permission: Read the workspace

  • List connected accounts

    Read

    Lists the social accounts, the Google Business places and the state of the ad connections of the workspace.

    Permission: Read the workspace

  • Manage a member

    Asks for approval in the app

    Asks to change the role or the accounts of a member, remove them or leave the workspace.

    Permission: Administration

  • Invite a member

    Asks for approval in the app

    Asks to invite up to ten people to the workspace, each with a role.

    Permission: Administration

  • Manage an invite

    Revokes a pending invite; sending it again asks for approval.

    Permission: Administration

    • revokeDirectYour AI client may ask you to confirm first.
    • send againAsks for approval in the app

  • Disconnect an integration

    Asks for approval in the app

    Asks to disconnect a social account or a Google Business place from the workspace.

    Permission: Administration

  • Update workspace settings

    Direct

    Changes the workspace name and which Zipe e-mails it receives.

    Permission: Administration

    Your AI client may ask you to confirm first.

  • Manage the news agenda

    Direct

    Adjusts the news agenda that feeds the daily opportunities e-mail.

    Permission: Administration

    Your AI client may ask you to confirm first.

For developers

Technical tool names, as the AI client shows them.

  • list_workspaces List workspaces
  • get_request_status Get a request
  • list_my_requests List my requests
  • list_members List members
  • list_connections List connected accounts
  • manage_member Manage a member
  • invite_member Invite a member
  • manage_invite Manage an invite
  • disconnect_integration Disconnect an integration
  • update_workspace_settings Update workspace settings
  • manage_news_agenda Manage the news agenda
Connection and preferences

  • Describe this connection

    Read

    Shows this connection: the AI client and the permissions granted.

  • Get the connected person

    Read

    Shows which Zipe account is using this connection.

  • Set my preference

    Direct

    Adjusts your content notices and the daily and weekly e-mails in a workspace.

    Permission: My preferences

    Your AI client may ask you to confirm first.

For developers

Technical tool names, as the AI client shows them.

  • describe_connection Describe this connection
  • get_account_identity Get the connected person
  • set_my_preference Set my preference

Permissions

Every permission shows up on the first authorization, and you tick the ones you want.

Read the workspace starts ticked. The others start ticked only when the AI client asks for them.

Paid features and Administration start unticked on the first authorization, even when the client asks for them.

The assistant sees every tool from the start. When it calls one that needs a permission you did not grant, the client asks you to authorize again: in Claude, the authorization screen; in ChatGPT, the connection notice; in Claude Code, /mcp.

An owner or admin can lock specific permissions for agents in each workspace, in Settings › AI agents, under Agent permissions. Everything starts unlocked, Conversations included.

  • Read the workspace

    Starts ticked

    Reads posts, metrics, calendar, Brain, automations and competitors of the workspaces you can access. Also reads the requests waiting for approval.

  • Read Conversations

    Ticked when the client asks

    Reads direct messages, comments, mentions and reviews of the connected accounts.

  • Reply in Conversations

    Ticked when the client asks

    Prepares replies and comment moderation. Anything that reaches the public waits for someone in the workspace to approve it.

  • Read Social Listening

    Ticked when the client asks

    Reads the queries, the collected mentions and the summaries of Social Listening.

  • Operate Social Listening

    Ticked when the client asks

    Creates and adjusts Social Listening queries. Activating, collecting and deleting wait for approval.

  • Create and publish content

    Ticked when the client asks

    Creates drafts, ideas and message templates. Scheduling and publishing wait for approval.

  • Manage automations

    Ticked when the client asks

    Creates and edits automations, which start paused. Activating waits for approval.

  • Adjust the Brain

    Ticked when the client asks

    Confirms or corrects Brain facts. Declaring a new fact and revising the strategy wait for approval.

  • Manage competitors

    Ticked when the client asks

    Starts or stops watching accounts in Insights. Always approved by someone in the workspace.

  • Paid features

    Starts unticked

    Reads and collections that use the workspace daily limit, the same ones the app offers.

  • Administration

    Starts unticked

    Prepares invites, roles, brand access and workspace settings. An owner or admin approves each change.

  • My preferences

    Ticked when the client asks

    Adjusts your own notice preferences in Zipe.

Security

How do I know I am connecting the real Zipe?

The address must be https://mcp.zipe.app/mcp, on the host mcp.zipe.app. Distrust any other.

The authorization screen opens on app.zipe.app and shows the AI client name and the permissions asked. If anything does not match, close it.

One workspace at a time

Each tool reads or writes a single workspace, and every answer, widget and request shows its name. No tool joins data from different workspaces.

If the assistant writes to a workspace up to 24 hours after reading or writing another one, the write becomes a request in the app, even if it would be direct.

Who is told when I connect?

You and the owners and admins of all your active workspaces get a notice in the bell and by e-mail, with the client name.

Each person can turn that notice off in Settings › Notifications, you included. The alert about misuse of the connection still arrives by e-mail and cannot be turned off.

Connection created by support

During a support session, an authorized Zipe person may connect an assistant operated by Zipe for up to 24 hours. That connection shows up with the Created by Zipe support badge, makes no administrative changes, approves no requests and ends with the session.

Approvals

  • Drafts and internal items that can be undone are done directly. Anything that reaches the public, changes access, costs or deletes becomes a request in the app.
  • Requests wait in the Agent requests queue of each workspace. Whoever has the permission approves them one by one or in a batch, several of the same kind at once, and can remove items from a batch before approving.
  • Anyone whose role in the workspace allows the action can approve, including whoever asked.
  • A request lasts 24 hours, or less when the social network 24-hour window to answer a message or comment closes first. The request card shows the real deadline.
  • No tool or widget approves a request. Approval only happens in the app.

Frequently asked questions

How much can the assistant use?

The assistant uses the workspace limits, as in the app, according to the workspace plan or contract.

Media reading, transcription and lookups of profiles and hashtags outside the watched ones only work with the Paid features permission ticked.

Why did the assistant ask for permission in the middle of the conversation?

The assistant sees every tool, but each one needs its own permission. When one is missing, the client opens the authorization again for you to decide.

In Claude Code this shows up in /mcp; to avoid it, declare the permissions in oauth.scopes.

How do I limit what agents do in my workspace?

In Settings › AI agents, an owner or admin can turn agent access off in the workspace, lock specific permissions and block a connection.

Why is Cursor not listed?

Zipe delivers the whole catalog at once (99 tools) and Cursor turns off tools above its limit of about 40. That is why there is no Cursor guide yet.

Troubleshooting

When a tool refuses a request, the assistant shows the reason. These are the most common ones.

The connection expired
Connect Zipe again from your AI client.
Code: token_expired
The connection was ended
Someone ended the connection in Settings › AI agents, or you did. Connect again if you still need it.
Code: token_revoked
A permission is missing
Authorize again when the client asks and tick the permission the tool needs. In Claude Code, use /mcp.
Code: insufficient_scope
Permission locked in this workspace
An owner or admin locked that permission for agents. Only they can unlock it, in Settings › AI agents.
Code: agent_permission_locked
AI agents turned off in the workspace
Ask an owner or admin of the workspace to check Settings › AI agents.
Code: workspace_mcp_disabled
Connection blocked in the workspace
Ask an owner or admin of the workspace to check Settings › AI agents.
Code: workspace_blocked_for_connection
Workspace suspended
The workspace owner can reactivate it in the Zipe app. Meanwhile, tools do not act on it.
Code: workspace_suspended
Payment pending in the workspace
The workspace owner can settle the subscription in the Zipe app.
Code: workspace_past_due
Workspace removed
The workspace no longer exists. Ask the assistant to list your workspaces and pick another one.
Code: workspace_removed
Your role does not allow the action
Where you are a viewer, the assistant only reads. Ask an owner or admin to change your role, if it makes sense.
Code: role_insufficient
Workspace not found
Ask the assistant to list your workspaces and use the exact name.
Code: workspace_unknown
Too many calls in a row
Wait a few seconds and ask again.
Code: burst_limited
Agent access paused
Zipe paused agent access for safety. Try later; the app keeps working.
Code: platform_paused
Workspace limit reached
The workspace limit for that action ran out and comes back on the date shown, as in the app.
Code: quota_exceeded
Reply window closed
The social network only accepts a reply within 24 hours of the person last message. Wait for them to write again.
Code: messaging_window_closed

Release notes

    • New: List workspaces. New tool.
    • New: Describe this connection. New tool.
    • New: Get the connected person. New tool.
    • New: Workspace overview. New tool.
    • New: List posts. New tool.
    • New: Get a post. New tool.
    • New: Account daily series. New tool.
    • New: Get the audience. New tool.
    • New: Get ads. New tool.
    • New: Get the content calendar. New tool.
    • New: List content ideas. New tool.
    • New: Check copy. New tool.
    • New: Search the Brain. New tool.
    • New: Get the brand context. New tool.
    • New: Read a Brain source document. New tool.
    • New: List automations. New tool.
    • New: Get an automation. New tool.
    • New: Automation performance. New tool.
    • New: List message templates. New tool.
    • New: Competitor panel. New tool.
    • New: List competitor content. New tool.
    • New: Analyze hashtags. New tool.
    • New: Search the workspace. New tool.
    • New: Fetch an item. New tool.
    • New: Account health. New tool.
    • New: Media reading result. New tool.
    • New: Read an image or video. New tool.
    • New: Transcribe a video. New tool.
    • New: Look up a public account. New tool.
    • New: Read competitor comments. New tool.
    • New: Discover posts by hashtag. New tool.
    • New: Get a request. New tool.
    • New: List my requests. New tool.
    • New: Create a post draft. New tool.
    • New: Update a post draft. New tool.
    • New: Cancel a scheduled post. New tool.
    • New: Schedule a post. New tool.
    • New: Retry a post. New tool.
    • New: Edit a published post. New tool.
    • New: Delete a post. New tool.
    • New: Create an idea. New tool.
    • New: Update an idea. New tool.
    • New: Move ideas. New tool.
    • New: Manage idea tags. New tool.
    • New: Update idea board properties. New tool.
    • New: Comment on an idea. New tool.
    • New: Create a post from an idea. New tool.
    • New: Create an approval link. New tool.
    • New: Revoke an approval link. New tool.
    • New: Delete ideas. New tool.
    • New: Record a Brain fact. New tool.
    • New: Revise the strategy. New tool.
    • New: Watch an account. New tool.
    • New: Stop watching an account. New tool.
    • New: Create an automation. New tool.
    • New: Update an automation. New tool.
    • New: Activate or pause an automation. New tool.
    • New: Delete an automation. New tool.
    • New: Manage a message template. New tool.
    • New: List conversations. New tool.
    • New: Read a conversation. New tool.
    • New: Conversation stats. New tool.
    • New: List comments. New tool.
    • New: Read a comment thread. New tool.
    • New: List mentions. New tool.
    • New: List reviews. New tool.
    • New: Mark a conversation as read. New tool.
    • New: Send a reply. New tool.
    • New: Reply to a comment privately. New tool.
    • New: Hide a comment. New tool.
    • New: Moderate a comment. New tool.
    • New: List listening queries. New tool.
    • New: Get a listening query. New tool.
    • New: Query listening mentions. New tool.
    • New: Get a listening mention. New tool.
    • New: Listening insights. New tool.
    • New: List saved mentions. New tool.
    • New: Create a listening query. New tool.
    • New: Update a listening query. New tool.
    • New: Decide on a listening suggestion. New tool.
    • New: Pause a listening query. New tool.
    • New: Set listening alert recipients. New tool.
    • New: Manage saved mentions. New tool.
    • New: Manage a listening community. New tool.
    • New: Request a listening sample. New tool.
    • New: Search places for Google reviews. New tool.
    • New: Request listening query activation. New tool.
    • New: Request listening query deletion. New tool.
    • New: Rate listening mentions. New tool.
    • New: List members. New tool.
    • New: List connected accounts. New tool.
    • New: Manage a member. New tool.
    • New: Invite a member. New tool.
    • New: Manage an invite. New tool.
    • New: Set brand access. New tool.
    • New: Disconnect an integration. New tool.
    • New: Update workspace settings. New tool.
    • New: Manage the news agenda. New tool.
    • New: Set my preference. New tool.