WordPress.org
Get WordPress

Plugin Directory

Changeset 3470953


Ignore:
Timestamp:
02/27/2026 09:43:00 AM (5 weeks ago)
Author:
rainafarai
Message:

aggiunte FAQ

Location:
notification-for-telegram
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • notification-for-telegram/tags/3.5/readme.txt

    r3470949 r3470953  
    281281both in option page and in the shortcode.
    282282
    283 
     283= Does this plugin support AI agents and MCP? =
     284Yes! Starting from version 3.5, this plugin supports the WordPress Abilities API
     285and is compatible with MCP (Model Context Protocol), the open standard that allows
     286AI agents like Claude, ChatGPT, and others to interact with WordPress autonomously.
     287
     288= What do I need to enable MCP support? =
     289You need to install two additional free plugins:
     290* Abilities API — github.com/WordPress/abilities-api/releases
     291* MCP Adapter — github.com/WordPress/mcp-adapter/releases
     292
     293Once both are active, the "Send Telegram Message" ability is automatically
     294available to any authorized AI agent. No extra configuration needed.
     295
     296= How does an AI agent authenticate? =
     297Via WordPress Application Passwords — go to Users → Your Profile →
     298Application Passwords, create one, and use it in your MCP client configuration.
     299Your main password is never exposed.
     300
     301= What can an AI agent do with this plugin? =
     302An authorized AI agent can:
     303* Send a Telegram message with custom text
     304* Include an optional inline button with label and URL
     305* Target a specific Telegram chat ID, overriding the default
     306
     307= How can I test the MCP integration without an AI? =
     308You can test everything for free using curl from your terminal.
     309
     310First, make sure the plugin is configured and the built-in "Send Test Message"
     311button works correctly in the plugin settings.
     312
     313Then run these commands in order:
     314
     315Step 1 — Initialize the session and get the Session ID:
     316
     317curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     318  -H "Content-Type: application/json" \
     319  -u "ADMIN:APP_PASSWORD" \
     320  -D - \
     321  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
     322
     323Look for the Mcp-Session-Id value in the response headers and copy it.
     324
     325Step 2 — Verify the tool is available:
     326
     327curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     328  -H "Content-Type: application/json" \
     329  -H "Mcp-Session-Id: YOUR-SESSION-ID" \
     330  -u "ADMIN:APP_PASSWORD" \
     331  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
     332
     333You should see "notification-for-telegram-send-message" in the response.
     334
     335Step 3 — Send a real Telegram message via MCP:
     336
     337curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     338  -H "Content-Type: application/json" \
     339  -H "Mcp-Session-Id: YOUR-SESSION-ID" \
     340  -u "ADMIN:APP_PASSWORD" \
     341  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"notification-for-telegram-send-message","arguments":{"message":"🤖 MCP is working!"}}}'
     342
     343If the message arrives in your Telegram chat — everything is working correctly.
     344
     345APP_PASSWORD = a WordPress Application Password (Users → Your Profile → Application Passwords).
     346
     347= Is MCP support stable? =
     348This feature is currently experimental. We welcome feedback and bug reports —
     349if you test it, please leave a review or open an issue on the plugin's GitHub page.
     350
     351= Where can I find the MCP endpoint? =
     352Once the required plugins are installed, your MCP endpoint will be available at:
     353https://yoursite.com/wp-json/nftb-telegram/mcp
    284354
    285355== Screenshots ==

  • notification-for-telegram/trunk/readme.txt

    r3470949 r3470953  
    281281both in option page and in the shortcode.
    282282
    283 
     283= Does this plugin support AI agents and MCP? =
     284Yes! Starting from version 3.5, this plugin supports the WordPress Abilities API
     285and is compatible with MCP (Model Context Protocol), the open standard that allows
     286AI agents like Claude, ChatGPT, and others to interact with WordPress autonomously.
     287
     288= What do I need to enable MCP support? =
     289You need to install two additional free plugins:
     290* Abilities API — github.com/WordPress/abilities-api/releases
     291* MCP Adapter — github.com/WordPress/mcp-adapter/releases
     292
     293Once both are active, the "Send Telegram Message" ability is automatically
     294available to any authorized AI agent. No extra configuration needed.
     295
     296= How does an AI agent authenticate? =
     297Via WordPress Application Passwords — go to Users → Your Profile →
     298Application Passwords, create one, and use it in your MCP client configuration.
     299Your main password is never exposed.
     300
     301= What can an AI agent do with this plugin? =
     302An authorized AI agent can:
     303* Send a Telegram message with custom text
     304* Include an optional inline button with label and URL
     305* Target a specific Telegram chat ID, overriding the default
     306
     307= How can I test the MCP integration without an AI? =
     308You can test everything for free using curl from your terminal.
     309
     310First, make sure the plugin is configured and the built-in "Send Test Message"
     311button works correctly in the plugin settings.
     312
     313Then run these commands in order:
     314
     315Step 1 — Initialize the session and get the Session ID:
     316
     317curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     318  -H "Content-Type: application/json" \
     319  -u "ADMIN:APP_PASSWORD" \
     320  -D - \
     321  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'
     322
     323Look for the Mcp-Session-Id value in the response headers and copy it.
     324
     325Step 2 — Verify the tool is available:
     326
     327curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     328  -H "Content-Type: application/json" \
     329  -H "Mcp-Session-Id: YOUR-SESSION-ID" \
     330  -u "ADMIN:APP_PASSWORD" \
     331  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'
     332
     333You should see "notification-for-telegram-send-message" in the response.
     334
     335Step 3 — Send a real Telegram message via MCP:
     336
     337curl -X POST "https://YOURSITE.com/wp-json/nftb-telegram/mcp" \
     338  -H "Content-Type: application/json" \
     339  -H "Mcp-Session-Id: YOUR-SESSION-ID" \
     340  -u "ADMIN:APP_PASSWORD" \
     341  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"notification-for-telegram-send-message","arguments":{"message":"🤖 MCP is working!"}}}'
     342
     343If the message arrives in your Telegram chat — everything is working correctly.
     344
     345APP_PASSWORD = a WordPress Application Password (Users → Your Profile → Application Passwords).
     346
     347= Is MCP support stable? =
     348This feature is currently experimental. We welcome feedback and bug reports —
     349if you test it, please leave a review or open an issue on the plugin's GitHub page.
     350
     351= Where can I find the MCP endpoint? =
     352Once the required plugins are installed, your MCP endpoint will be available at:
     353https://yoursite.com/wp-json/nftb-telegram/mcp
    284354
    285355== Screenshots ==
Note: See TracChangeset for help on using the changeset viewer.