Documentation

AI Agent for WordPress

An AI assistant powered by Anthropic's Claude that answers your visitors from your site's content — 24/7, in your brand and language. You use your own Anthropic API key and stay in control of your data.

Overview

1. Introduction

AI Agent is a chat assistant for WordPress powered by Anthropic's Claude. It answers visitors based on what you define in the system prompt — your services, prices, business hours, and contact details — 24 hours a day, in the visitor's language.

You pay for the model directly to Anthropic through your own API key (you control the cost and the data). media-met only charges for the plugin license, not for AI usage.

Getting started

2. Installation

  1. In the WordPress admin, go to Plugins → Add New → Upload Plugin and upload the ZIP.
  2. Activate the plugin. AI Agent appears in the menu.
  3. Open AI Agent → Settings for further configuration.
License

3. License activation

  1. Open AI Agent → Settings.
  2. Paste the license key you received by email and click Activate.

Key format: AAGT-XXXX-XXXX-XXXX-XXXX

License terms
  • The license is valid for 12 months from activation and is verified through the media-met license server.
  • The number of domains depends on the plan: Starter (1 domain), Business (3 domains), Agency (unlimited).
  • You can deactivate the license and move it to another domain (Settings → Deactivate → Activate on the new one).
Anthropic

4. Anthropic API key

Each user uses their own Anthropic API key.

  1. Sign up at console.anthropic.com and open Settings → API Keys.
  2. Create a key and copy it.
  3. Paste it into AI Agent → Settings and save.
  4. Add credit under Billing in the Anthropic console.
CostThe recommended model is Claude Haiku — fast and economical. For a site with ~50 visits per day, the typical cost is just a few euros per month, paid directly to Anthropic based on usage.
The key setting

5. System prompt

The system prompt is the most important setting — it's where you describe what your site offers, the tone of communication, and contact details. The richer it is, the more accurate the answers.

Example for an agency:

"You are the assistant of the digital agency [name]. You inform potential clients about services (web design, SEO, branding), prices, and the collaboration process. Contact: info@agency.com."

NoteThe agent answers solely based on what you give it. If it gives incomplete or inaccurate answers, expand the system prompt with more detail.
Display

6. Widget and appearance

  • Enable the Widget active option in the settings so the chat shows to visitors.
  • You can display the widget automatically across the whole site, or insert it with a shortcode or block at a specific location.
  • Customize the assistant's colors, name, and avatar to match your brand.
Multilingual

7. Language

The agent automatically answers in the visitor's language. If you want it to always answer in a specific language, add this to the system prompt: "Always answer in English, regardless of the language of the question."

Privacy

8. GDPR and privacy

You become the data controllerBy installing the plugin, you become the controller of the personal data of visitors who use the chat. Make sure your privacy setup is compliant.
  • Update the Privacy Policy on your site and enter its URL in AI Agent → Settings → GDPR.
  • Keep the Privacy notice enabled in the chat.
  • The IP address is not stored. Conversations are automatically deleted after a set period (default 12 months).
  • You manage conversations in AI Agent → Conversations — "Delete all" or, for a single session, "Delete session (GDPR)".
Help

9. Troubleshooting

"Network problem" — the chat doesn't work

Possible causeSolution
API key not entered or invalidAI Agent → Settings → check the API key
No credit on the Anthropic accountconsole.anthropic.com → Billing → add credit
License not activeAI Agent → Settings → activate the license key
Hosting blocks the REST APIAsk your host to allow access to /wp-json/aagt/v1/
ModSecurity / WAF blocks the requestsDisable ModSecurity for your domain in cPanel

The widget doesn't appear

  • Check that "Widget active" is enabled and the license is active (green status).
  • Reload the page with a hard refresh (Ctrl/Cmd + Shift + R).
  • Temporarily disable other plugins to check for a conflict.

The agent answers in the wrong language or inaccurately

Expand the system prompt — for language, add an instruction to always answer in your preferred language; for accuracy, add more detail about services, prices, and contacts.

License

10. License renewal

The license is valid for 12 months from activation; an email reminder arrives 30 days before expiry.

After expiry: the plugin stays installed and your settings are kept, but the chat widget no longer shows to visitors and you stop receiving updates. The data in the database remains untouched.

Renewal: email info@media-met.hr with the subject "AI Agent license renewal", pay for the renewal, then deactivate the old key in Settings and activate the new one.

Requirements

11. Technical requirements

5.8+WordPress (6.x tested)
7.4+PHP (8.x recommended)
ClaudeAnthropic API key
EN / HR +multilingual chat
per domainlicense + verification
Questions

12. FAQ

Do I need my own Anthropic API key?
Yes. Each user uses their own key and pays Anthropic directly based on usage. media-met only charges for the plugin license.
How much does using the AI cost?
It depends on traffic and model. With Claude Haiku, for a site with ~50 visits per day, the cost is usually just a few euros per month.
How many domains does the license cover?
It depends on the plan: Starter 1 domain, Business 3 domains, Agency unlimited. You can deactivate the license and move it to another domain.
Does it answer only about my content?
Yes — the agent answers based on the system prompt you give it. The more detail you provide, the more precise the answers.
What data does it collect?
The conversation content, the page URL, and optionally the visitor's email. The IP address is not stored, and conversations are automatically deleted after a set period.
Does it work in other languages?
Yes. The agent answers in the visitor's language, and with an instruction in the system prompt you can force it to always answer in a specific language.
Contact

13. Contact and support

For questions and help, email info@media-met.hr (include your site URL, a description of the problem, and a screenshot of the error). More about products and services at media-met.hr.

media-met, obrt za računalne usluge · OIB 98877392843
AI Agent · media-met.hr