Documentación
Cómo conectar tu agente IA, qué puede hacer y qué está en camino.
Configuración
Conectar tu agente
Bridge expone un endpoint MCP estándar en tu WordPress. Para conectar tu agente necesitas dos cosas: un token y la URL del servidor.
El token se genera desde el panel: Halves Manager → Ajustes → Bridge → Nuevo token. La URL del servidor es siempre:
{tu-sitio.com}/wp-json/mcp/v1/rpc
Claude Desktop
Edita el archivo de configuración:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%Claudeclaude_desktop_config.json
{
"mcpServers": {
"Halves": {
"url": "https://tu-sitio.com/wp-json/mcp/v1/rpc",
"headers": {
"Authorization": "Bearer TU_TOKEN"
}
}
}
}
Reinicia Claude Desktop. Halves aparece en la lista de servidores MCP.
Claude Code
claude mcp add halves
--url https://tu-sitio.com/wp-json/mcp/v1/rpc
--header "Authorization: Bearer TU_TOKEN"
Verifica con claude mcp list.
Cursor
Cursor → Settings → MCP → Add server:
{
"name": "Halves",
"url": "https://tu-sitio.com/wp-json/mcp/v1/rpc",
"headers": { "Authorization": "Bearer TU_TOKEN" }
}
Zed
En ~/.config/zed/settings.json:
{
"context_servers": {
"halves": {
"settings": {
"url": "https://tu-sitio.com/wp-json/mcp/v1/rpc",
"headers": { "Authorization": "Bearer TU_TOKEN" }
}
}
}
}
Continue (VSCode / JetBrains)
En ~/.continue/config.json, sección mcpServers:
{
"mcpServers": [
{
"name": "Halves",
"url": "https://tu-sitio.com/wp-json/mcp/v1/rpc",
"requestOptions": {
"headers": { "Authorization": "Bearer TU_TOKEN" }
}
}
]
}
Compatible con cualquier cliente MCP. Verificado con Claude (Anthropic).
↑ Volver al índiceHerramientas MCP
Qué puede hacer el agente
Bridge da acceso a lectura completa de tu sitio y escritura de posts y páginas — suficiente para flujos editoriales básicos. Bridge Pro añade escritura sobre el resto de recursos, eliminación, OAuth y audit log.
Bridge — 32 herramientas
| Herramienta | Descripción | Scope |
|---|---|---|
list_posts · get_post · search_posts | Leer y buscar posts | content.read |
create_post · update_post · publish_post · unpublish_post | Crear y editar posts | content.write |
list_pages · get_page | Leer páginas | content.read |
create_page · update_page · publish_page · unpublish_page | Crear y editar páginas | content.write |
list_media · get_media | Leer biblioteca de medios | content.read |
list_users · get_user | Leer usuarios | users.read |
list_comments · get_comment | Leer comentarios | content.read |
list_categories · get_category · list_tags · get_tag | Leer categorías y etiquetas | content.read |
list_menus · get_menu | Leer menús | settings.read |
get_site_settings · get_active_theme · list_plugins | Leer ajustes y configuración | settings.read |
| Add-on WooCommerce (requiere WooCommerce activo) | ||
woo_list_products · woo_get_product | Leer productos | woocommerce.read |
woo_list_orders · woo_get_order | Leer pedidos | woocommerce.read |
| Add-on Halves Events (requiere Halves Events activo) | ||
list_events · get_event | Leer eventos | events.read |
list_ticket_types | Leer tipos de entrada de un evento | events.read |
Bridge Pro — 54 herramientas
Incluye todo lo anterior más:
| Herramienta | Descripción | Scope |
|---|---|---|
delete_post · delete_page | Eliminar posts y páginas | content.write |
upload_media · update_media · delete_media | Gestionar medios | content.write |
create_user · update_user · delete_user | Gestionar usuarios | users.write |
reply_to_comment · update_comment_status · delete_comment | Moderar comentarios | content.write |
create_category · update_category · delete_category | Gestionar categorías | content.write |
create_tag · update_tag · delete_tag | Gestionar etiquetas | content.write |
create_menu · update_menu · delete_menu | Gestionar menús | settings.write |
add_menu_item · update_menu_item · delete_menu_item | Gestionar ítems de menú | settings.write |
update_site_settings | Modificar ajustes del sitio | settings.write |
| Add-on WooCommerce | ||
woo_get_sales_report | Informe de ventas por rango de fechas | woocommerce.read |
woo_update_product | Modificar precio, stock y estado de un producto | woocommerce.write |
woo_update_order_status | Cambiar el estado de un pedido | woocommerce.write |
woo_create_coupon | Crear cupones de descuento | woocommerce.write |
| Add-on Halves Events | ||
create_event · update_event · delete_event | Gestionar eventos | events.write |
create_ticket_type · update_ticket_type · delete_ticket_type | Gestionar tipos de entrada | events.write |
Scopes
Cada token declara qué scopes tiene activos. El agente solo ejecuta herramientas cubiertas por los scopes del token — aunque tengas Bridge Pro, un token con solo content.read no puede escribir nada.
| Scope | Acceso |
|---|---|
content.read | Leer posts, páginas, medios, comentarios, taxonomías y menús |
content.write | Crear y modificar posts, páginas, medios, comentarios, taxonomías y menús |
settings.read | Leer ajustes del sitio, tema activo y plugins instalados |
settings.write | Modificar ajustes del sitio |
users.read | Leer usuarios y perfiles |
users.write | Crear, modificar y eliminar usuarios |
woocommerce.read | Leer productos, pedidos y datos de la tienda |
woocommerce.write | Modificar productos, pedidos y cupones |
events.read | Leer eventos y tipos de entrada (requiere Halves Events) |
events.write | Crear y modificar eventos y tipos de entrada (requiere Halves Events) |
Roadmap
En desarrollo
Sin fechas comprometidas, en orden aproximado de prioridad.
- Add-on Elementor — Herramientas MCP para operar páginas y secciones de Elementor desde el agente.
- Tokens con expiración — Acceso temporal acotado en tiempo y scope, sin necesidad de revocar manualmente.
- halves-seo — Herramientas para gestionar metadatos, sitemap y robots.txt.
- halves-protect — Control de acceso por rol y contraseña desde el agente.
- Soporte multiidioma — El agente responde en el idioma del operador.
Compatible con cualquier cliente MCP: Claude Desktop, Claude Code, Cursor, Zed, Continue y otros. Verificado con Claude (Anthropic).