> For the complete documentation index, see [llms.txt](https://docs.famewall.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.famewall.io/ai-agents.md). # Connect AI Agents (MCP) Famewall can plug straight into the AI assistants you already use. Once connected, you can ask **Claude** or **ChatGPT** things like *"show me my newest testimonials"* or *"add this 5-star review to my homepage wall"* and it happens, without you opening the dashboard. You can also connect your own **autonomous agent** (an AI that runs on its own, like an n8n workflow or a script) so it can work with your testimonials around the clock. {% hint style="info" %} **What is MCP?** MCP (Model Context Protocol) is the standard way that AI assistants connect to outside tools. You don't need to understand how it works. Think of it as a secure doorway that lets your AI assistant talk to your Famewall account. You stay in control of what it's allowed to do, and you can disconnect at any time. {% endhint %} ## What you'll need * A Famewall account on a **paid plan** (AI agent access is a paid feature). * One AI assistant: **Claude**, **ChatGPT**, or your own agent. * **2–3 minutes.** No code required for Claude or ChatGPT. ## Your Famewall MCP address Everything connects using one web address. This is the only value you'll ever need to paste: ``` https://api.famewall.io/mcp ``` You can copy it straight from the **Connect AI Agents** page in your Famewall dashboard (there's a **Copy URL** button next to it). ## Connect your AI Pick the assistant you use. Claude and ChatGPT sign you in securely with your Famewall account — there's **no key to copy or paste**. {% tabs %} {% tab title="Claude" %} **Takes about 2 minutes.** Works on Claude on the web and the Claude desktop app. 1. Open **Claude** and go to **Settings → Connectors**. 2. Click **Add custom connector**. 3. When Claude asks for the connector URL, paste your Famewall address: ``` https://api.famewall.io/mcp ``` 4. Click **Connect**, sign in with your **Famewall** account, and pick what Claude is allowed to do. 5. You're connected! Open any chat and just ask it to work with your testimonials. {% hint style="success" %} **Try this first:** *"Show me my 5 most recent testimonials."* {% endhint %} {% endtab %} {% tab title="ChatGPT" %} **Takes about 3 minutes.** Connectors live in ChatGPT's settings. 1. In **ChatGPT**, turn on **Developer mode**, then open **Settings → Connectors**. 2. Add a new connector and choose **"MCP server"**. 3. Paste your Famewall address as the **server URL**: ``` https://api.famewall.io/mcp ``` 4. Continue, then **sign in with your Famewall account** to authorize it. 5. You're connected! Ask ChatGPT to pull up or add testimonials for you. {% hint style="success" %} **Try this first:** *"What submissions are waiting for me to review in Famewall?"* {% endhint %} {% endtab %} {% tab title="Autonomous agent" %} For AI agents that run on their own, 24/7 — tools like **n8n**, the **OpenAI Agents SDK**, the **Claude Agent SDK**, and your own scripts built on the MCP SDK. Because these agents can't click a "Sign in" button, they authenticate with a **secret key** instead. 1. **Point your agent at the Famewall MCP address:** ``` https://api.famewall.io/mcp ``` 2. **Generate a secret key.** On the **Connect AI Agents** page in Famewall, open the **Autonomous agent** tab and click **Generate Key**. Your key starts with `fw_ag_`. Copy it now as it's only shown once. 3. **Send that key as a Bearer token on every request:** ``` Authorization: Bearer fw_ag_your_key_here ``` {% hint style="warning" %} **Keep this key server-side.** Anyone who has it can act on your Famewall account. Never put it in browser code, a public repository, a screenshot, or anywhere a person could copy it. {% endhint %} {% endtab %} {% endtabs %} ## Try it: first prompts to type Not sure where to start? Paste any of these into your connected assistant: * *"Show me my 5 most recent testimonials."* * *"Add a 5-star testimonial from Jane Doe that says 'Best tool I've used all year.'"* * *"Search my testimonials for anything that mentions 'support'."* * *"How many testimonials do I have in total?"* * *"What submissions are waiting for me to review?"* * *"Fix the typo in that testimonial and update the author's job title."* * *"Rename my 'default' wall to 'Customer Love'."* Your assistant will always tell you what it did and confirm it back to you. ## What it can do once connected Your AI assistant can help with four kinds of tasks. You choose which of these to allow when you connect (see [Choosing what it can access](#choosing-what-it-can-access)). **📖 Look things up** * Pull up your latest testimonials, or open a specific one. * Search across your testimonials by keyword, wall, star rating, or type. * Get a quick count of your walls, testimonials, and pending submissions. **➕ Add testimonials by chat** * Paste a customer's words and have them added to the right wall — formatted and attributed, with a rating and links if you have them. **✏️ Tidy up wording** * Fix a typo, polish an author's job title, or correct a link on an existing testimonial. * Rename a wall or update its description. **📥 Check what's waiting** * See the submissions that came in through your collection form, so you know what's ready for you to review. ### Full list of abilities For the technically curious, here's everything the assistant can do, with the exact tool name and the permission each one needs: | Plain-English action | Tool | Permission needed | | ----------------------------------------------------- | ---------------------------- | ----------------------- | | List your walls | `list_walls` | View your walls | | Open one wall (with its testimonial count) | `get_wall` | View your walls | | List testimonials on a wall | `list_testimonials` | Read your testimonials | | Open one testimonial | `get_testimonial` | Read your testimonials | | Search testimonials by text, wall, rating or type | `search_testimonials` | Read your testimonials | | Count walls, testimonials & pending submissions | `get_account_usage` | View account insights | | See submissions waiting for review | `list_collected_submissions` | View submissions | | Add a text testimonial to a wall | `add_text_testimonial` | Add & edit testimonials | | Edit a testimonial's wording, author, rating or links | `update_testimonial` | Add & edit testimonials | | Rename a wall or change its description | `update_wall_settings` | Edit your walls | ## Choosing what it can access When you connect Claude or ChatGPT, Famewall shows you a permissions screen. **Tick only what you need** — you can always allow more later. Each permission unlocks a group of abilities: | Permission | What it lets your assistant do | | --------------------------- | ----------------------------------------------------- | | **View your walls** | See your walls of love and their settings. | | **Read your testimonials** | Browse and search the testimonials you've collected. | | **View submissions** | See responses waiting from your collection forms. | | **View account insights** | Read your usage, plan, and account stats. | | **Add & edit testimonials** | Create new testimonials and tidy up existing wording. | | **Edit your walls** | Update wall names and descriptions. | {% hint style="info" %} You may also see options for features that are still rolling out (like reviewing submissions). Leave those unticked if you don't need them yet. {% endhint %} ## Managing your autonomous agent key Your `fw_ag_` key only matters for the **Autonomous agent** option. Claude and ChatGPT never use one. From the **Connect AI Agents** page you can: * **Regenerate** the key — this creates a fresh key and **immediately stops the old one from working**. Update your agent with the new key afterward. * **Revoke** the key — this permanently switches off autonomous access until you generate a new key. Regenerate if you think a key may have leaked; revoke if you want to shut off an agent entirely. ## Rate limits There's a fair-use limit of roughly **120 requests per minute** per connection. If an assistant goes over it, requests return a rate-limit error - just wait a minute and try again. Normal chatting will never come close to this. ## Troubleshooting ### I can't find where to add a connector * **Claude:** Custom connectors live under **Settings → Connectors → Add custom connector**. If you don't see it, make sure your Claude app is up to date. * **ChatGPT:** You must turn on **Developer mode** first, then connectors appear under **Settings → Connectors**. ### It asks me to sign in again, or says "unauthorized" Your secure session with Famewall expired. Reconnect the connector and sign in again. It only takes a moment. ### My autonomous agent gets an "unauthorized" error * Make sure you're sending the key as `Authorization: Bearer fw_ag_...` with **no extra spaces**. * If you recently **regenerated** or **revoked** the key, the old one no longer works - generate a new key and update your agent. ### I hit a rate-limit error You're sending requests too quickly. Wait about a minute and try again. ### Nothing happens / it says I need to upgrade AI agent access is available on **paid Famewall plans**. Upgrade from the pricing page, then connect again. ## Related docs {% content-ref url="/pages/fX8c8AfsYmKhqjBWM7wr" %} [API Guide](/api-guide.md) {% endcontent-ref %} {% content-ref url="/pages/L5yHAT6FOplSG5xFQOay" %} [Zapier Integration](/zapier-integration.md) {% endcontent-ref %} {% content-ref url="/pages/HHGyRpucaf8eJlwMjijj" %} [Webhook Integration](/webhook-integration.md) {% endcontent-ref %} {% content-ref url="/pages/U3DF7mtstP8dVR3rdcFn" %} [Make.com Integration](/make-com-integration.md) {% endcontent-ref %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.famewall.io/ai-agents.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.