Servidor MCP

Exponer las capacidades de la aplicación seleccionada a los clientes locales de MCP

La página del Servidor MCP inicia y detiene el servidor local del Protocolo de Contexto de Modelo de la aplicación. MCP permite que un cliente compatible, como un asistente de IA o herramienta de automatización, descubra las herramientas proporcionadas por la aplicación y solicite esas herramientas a través de un punto final HTTP local.

El servidor está integrado en la aplicación en ejecución. No es un servicio de línea de comandos separado, y no es un servicio de internet público. Inícialo solo cuando desees que un cliente MCP se conecte.

Lo que MCP puede controlar

MCP expone capacidades de dominio que la aplicación publica explícitamente. No es una superficie de control remoto general para la ventana de la aplicación.

Para ControlMyNikon, el primer módulo útil es NikonMCP. NikonMCP es para el estado de la cámara Nikon y acciones de la cámara como captura, vista en vivo, control de conexión y enfoque automático de contraste.

Usa NikonMCP para la lista de herramientas específicas de Nikon y detalles del estado de la cámara.

Controles de página

Iniciar comienza a alojar el punto final de MCP.
Detener finaliza el punto final de MCP y libera el puerto.
Dirección establece la dirección local para escuchar.
Puerto establece el puerto TCP.
Punto final configurado muestra la URL que se debe proporcionar al cliente de MCP.
Copiar URL copia el punto final configurado.
El token Bearer es el token que los clientes deben enviar con las solicitudes.
Copiar token copia el token.
Regenerar token crea un nuevo token e invalida el antiguo después de que se reinicie el servidor.
Módulos lista los módulos de MCP declarados por la aplicación, como NikonMCP.
Habilitado o Deshabilitado controla si un módulo contribuye con herramientas al servidor.
Registro muestra mensajes de inicio, detención, solicitud, rechazo y llamada a herramientas del servidor.
Limpiar en el menú de clic derecho del Registro limpia el registro visible de la página.

El punto final predeterminado es:

http://127.0.0.1:50507/mcp

El servidor solo se inicia cuando al menos un módulo está habilitado y el token Bearer no está vacío. La dirección, el puerto, el token Bearer y la configuración del módulo están respaldados por el perfil. Si el Servidor MCP está en ejecución cuando se guarda el perfil o se cierra la aplicación, ese perfil puede iniciarlo nuevamente la próxima vez.

Dirección y puerto

Usa 127.0.0.1 cuando el cliente MCP se ejecute en la misma computadora. Esta es la configuración más segura y común.

Usa una dirección IPv4 de LAN asignada a esta computadora solo cuando un cliente de confianza en la misma red privada deba conectarse. Se rechazan enlaces comodín, de difusión, no locales y no IPv4.

No expongas el punto final de MCP a través del reenvío de puertos del enrutador, Wi-Fi público, VPN no confiables o reglas de firewall expuestas a internet. Las herramientas de MCP pueden solicitar acciones reales de la aplicación, así que trata el punto final y el token como una clave de control local.

Conectando un cliente

Usa un cliente HTTP MCP transmitible. Configura el cliente con:

URL del punto final: el punto final configurado mostrado en la página.
Encabezado de autorización: Authorization: Bearer your-token.

La mayoría de los clientes piden la URL y un token Bearer o encabezado personalizado. Si tu cliente almacena encabezados por separado, usa:

Header name: Authorization
Header value: Bearer your-token

Reemplaza your-token con el token mostrado en la página del Servidor MCP. No incluyas comillas alrededor del token.

Forma técnica de la solicitud

Los clientes de MCP normalmente envían estas solicitudes por ti. Los detalles a continuación son útiles al configurar o depurar un cliente.

El punto final acepta solicitudes HTTP POST a /mcp. El cuerpo de la solicitud es JSON-RPC. El cliente debe incluir el token Bearer cuando se configura un token.

Solicitud de inicialización:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"local-client","version":"1.0"}}}

Notificación inicializada:

{"jsonrpc":"2.0","method":"notifications/initialized","params":{}}

Listar herramientas:

{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

Llamar a una herramienta:

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"nikon_hello","arguments":{}}}

El servidor devuelve resultados estructurados de herramientas. Los rechazos esperados de la aplicación, como una cámara no conectada, se devuelven como resultados normales de herramientas con ok establecido en false.

Estados del servidor

Detenido significa que el punto final no está escuchando.
Iniciado significa que el punto final está escuchando en la dirección y puerto configurados.
Listo para iniciar el Servidor MCP significa que la página está cargada y las configuraciones están disponibles.
Host de MCP iniciado significa que el servidor se inició correctamente.
Host de MCP detenido significa que el servidor se detuvo normalmente.
No se ha registrado tiempo de ejecución de MCP significa que la aplicación no declaró un tiempo de ejecución de MCP para esta página.
El host de MCP está deshabilitado por el perfil significa que el perfil guardado tiene el alojamiento desactivado.
El host de MCP no se inició porque no hay módulos de MCP declarados habilitados significa que todas las tarjetas de módulo están deshabilitadas.
El host de MCP no pudo iniciarse significa que la dirección, el puerto o el entorno local impidieron el inicio.

El área de Registro proporciona el mensaje exacto para fallos y solicitudes rechazadas.

Notas de seguridad

El Servidor MCP utiliza HTTP local en texto plano más autorización con token Bearer. El token protege la ruta de solicitud, pero la conexión no está cifrada. Usa el bucle de retorno para clientes de la misma computadora siempre que sea posible. Usa el enlace de LAN solo en redes y máquinas en las que confíes.

Regenera el token si se compartió con un cliente en el que ya no confías. Después de regenerar el token, detén e inicia el Servidor MCP para que los clientes deban usar el nuevo valor.

Solución de problemas

Si Iniciar está deshabilitado:

Habilita al menos un módulo.
Confirma que la Dirección no esté vacía.
Confirma que el Puerto esté entre 1 y 65535.
Confirma que el token Bearer no esté vacío.
Detén el servidor antes de cambiar la Dirección, el Puerto o el token Bearer.

Si Iniciar falla:

Otro proceso puede estar utilizando ya el puerto.
La dirección puede no estar asignada a esta computadora.
Elige otro puerto o dirección y vuelve a intentarlo.
Revisa el Registro para el mensaje de fallo exacto.

Si el cliente no puede conectarse:

Confirma que el servidor muestre Iniciado.
Confirma que la URL del cliente coincida exactamente con el punto final configurado.
Usa 127.0.0.1 solo para clientes en la misma computadora.
Para otra computadora de LAN, usa la dirección IPv4 de LAN de esta computadora y confirma que las reglas del firewall permitan la conexión.
Confirma que el cliente soporte MCP HTTP transmitible, no MCP solo de stdio.

Si el cliente recibe 401 Unauthorized:

Agrega el encabezado Authorization.
Confirma que el encabezado comience con Bearer .
Confirma que el token no esté en blanco.

Si el cliente recibe 403 Forbidden:

Confirma que el token coincida exactamente con el token Bearer actual.
Si regeneraste el token, actualiza el cliente.
Si la solicitud incluye un encabezado Origin, confirma que provenga de un origen local permitido.

Si el cliente recibe 405 Method Not Allowed:

El cliente probablemente esté usando HTTP GET.
Configura el cliente para llamadas a herramientas HTTP transmitibles que envíen POST /mcp.

Si no aparecen herramientas de Nikon:

Confirma que la tarjeta del módulo NikonMCP esté Habilitada.
Detén e inicia el Servidor MCP después de cambiar la habilitación del módulo.
Confirma que el cliente se haya actualizado o reconectado después de que el servidor se reinició.