Saltar al contenido principal

Internal install instructions for Developer Assistant

Prerequisites​

Required permissions​

You must have the correct AD group permissions. Request the appropriate AD group using Omada:

  • Internal Guidewire users: gwa.pd_lower.codelift.user
  • Customers: gwa.any_planet_class.codelift.user

Development container tool requirements​

Depending on your development container tool, you might need to configure port forwarding and browser integration:

  • Visual Studio Code: Automatically detects ports and includes browser integration.
  • Dev CLI: Requires manual configuration.
Note: If you use the Dev CLI, you will lose IDE integration capabilities. It's recommended to use Visual Studio Code for the best experience.

Required ports:

  • Port 9876 must be forwarded for Okta callback.
  • Port 3000 must be forwarded for your Jutro app (or other port matching your Jutro app port config).

Setup steps​

Both options assume you are using the GW AI Dev tool which provides Claude Code with the Jutro Developer Assistant MCP pre-installed.

Note: When using the GW AI Dev tool, you should use the standard devcontainer profile. This profile includes Jutro Developer Assistant MCP in the base configuration, with port mapping and the .mcp.json file configured by default. The concurrent devcontainer profile does not have any ports mapped, so Developer Assistant MCP won't be able to authenticate with Okta.

Choose the setup method that best fits your environment:

Option 1 (recommended): Quick setup using the Dev CLI standard profile​

Note: If you are using a standard terminal environment, you must use the jutro-dev-assistant login command to trigger the authentication flow. For more information about this command, see Explicit login and logout commands.

1. Install the Jutro development agent skill​

La habilidad del agente de desarrollo de Jutro es una predefinida que permite a Claude Code utilizar de manera más eficaz el servidor de Developer Assistant MCP. Esta habilidad de agente incluye instrucciones optimizadas para flujos de trabajo comunes y utiliza un enfoque de divulgación progresiva, lo que permite a Claude cargar documentación relevante de manera eficiente, en lugar de cargar todas las instrucciones del MCP a la vez. Una vez instalada, la habilidad del agente se puede cargar automáticamente cuando se trabaja en tareas de interfaz de usuario, Jutro o el SDK de Digital.

Instale la habilidad del agente ejecutando el siguiente comando en el terminal:

jutro-dev-assistant skill-install

Make sure the Developer Assistant MCP server is successfully connected.

2. Start Claude Code and verify the MCP server connection​

Launch Claude Code and check that the MCP server is connected properly by running the following command in your terminal:

claude
/mcp  # Check server status
Note: You might see a message indicating that the server is disabled by default:
jutro-developer-assistant · ◯ disabled

If you see this message, you can enable the server by pressing Enter.

If the MCP server is configured correctly, you will see the following output:

jutro-developer-assistant ✓ connected

3. Setup Developer Assistant instructions for your Claude Code agent​

Complete la instalación configurando las instrucciones de Developer Assistant para su agente Claude Code. Escriba el siguiente comando de barra diagonal en la entrada de chat de Claude Code:

/jutro-developer-assistant:setup claude
Tip: Claude Code incluye la funcionalidad de autocompletar el comando de barra. Cuando escriba / en la entrada de chat, Claude Code sugerirá los comandos disponibles desde los servidores MCP conectados. Para usar la función de autocompletar para este comando, escriba /jutro en la entrada de chat. Claude Code muestra comandos coincidentes, entre los que se incluye /jutro-developer-assistant:setup (MCP). Utilice las teclas de flecha para seleccionar el comando, pulse Tab para autocompletar y, a continuación, escriba claude y pulse Enter.

Option 2: Full setup when Developer Assistant MCP is not preconfigured​

If you're not using Visual Studio Code, you'll need to manually configure port forwarding. This option is for users who wants to use Jutro Developer Assistant MCP with Dev CLI profiles that don't support Developer Assistant MCP by default.

1. Configure port forwarding​

Ensure that port 9876 is forwarded for Okta authentication by adding the following snippet to your devcontainer.json:

{
  ...
  "appPort": [
      "127.0.0.1:9876:9876"
  ]
  ...
}

2. Add the MCP server to Claude Code​

Register the Jutro Developer Assistant MCP server with Claude Code by running the following command in your terminal:

claude mcp add --transport stdio jutro-developer-assistant --scope project \
  --env OKTA_DOMAIN=https://guidewire-hub.oktapreview.com/oauth2/ausj9ftnbxOqfGU4U0h7 \
  --env OKTA_CLIENT_ID=0oa2g11jcbnTlcU4N0h8 \
  --env DEVASSISTANT_SERVICE_URL=https://devassistant.api.int.ccs.guidewire.net \
  -- jutro-dev-assistant

3. Install the Jutro development agent skill​

La habilidad del agente de desarrollo de Jutro es una predefinida que permite a Claude Code utilizar de manera más eficaz el servidor de Developer Assistant MCP. Esta habilidad de agente incluye instrucciones optimizadas para flujos de trabajo comunes y utiliza un enfoque de divulgación progresiva, lo que permite a Claude cargar documentación relevante de manera eficiente, en lugar de cargar todas las instrucciones del MCP a la vez. Una vez instalada, la habilidad del agente se puede cargar automáticamente cuando se trabaja en tareas de interfaz de usuario, Jutro o el SDK de Digital.

Instale la habilidad del agente ejecutando el siguiente comando en el terminal:

jutro-dev-assistant skill-install

4. Start Claude Code and verify the MCP server connection​

Launch Claude Code and check that the MCP server is connected properly by running the following command in your terminal:

claude
/mcp  # Check server status

Make sure Developer Assistant's MCP Server is successfully connected.

5. Setup Developer Assistant instructions for your Claude Code agent​

Complete la instalación configurando las instrucciones de Developer Assistant para su agente Claude Code. Escriba el siguiente comando de barra diagonal en la entrada de chat de Claude Code:

/jutro-developer-assistant:setup claude
Tip: Claude Code incluye la funcionalidad de autocompletar el comando de barra. Cuando escriba / en la entrada de chat, Claude Code sugerirá los comandos disponibles desde los servidores MCP conectados. Para usar la función de autocompletar para este comando, escriba /jutro en la entrada de chat. Claude Code muestra comandos coincidentes, entre los que se incluye /jutro-developer-assistant:setup (MCP). Utilice las teclas de flecha para seleccionar el comando, pulse Tab para autocompletar y, a continuación, escriba claude y pulse Enter.

Basic usage​

To verify that the Developer Assistant MCP setup was successful, you can run a basic prompt in Claude Code that requests the Jutro Button API documentation:

> Show me API of Jutro Button

If the setup was successful, the following happens:

  1. A popup appears requesting browser authentication through Okta single sign-on (SSO).
  2. The Okta authentication flow can be completed successfully in your browser.
  3. The MCP server is invoked to retrieve the Jutro Button API documentation.
  4. Claude Code responds with information from the retrieved documentation.

Comandos explícitos de inicio y cierre de sesión​

El comando jutro-dev-assistant sirve como punto de entrada para el servidor de MCP basado en STDIO. Además, proporciona funcionalidades explícitas de inicio y cierre de sesión que pueden ser útiles en todas las opciones de configuración:

  • jutro-dev-assistant login: Activa manualmente la autenticación.
  • jutro-dev-assistant logout: Borra los tokens de autenticación.
Note: El comando jutro-dev-assistant login requiere que las variables de entorno OKTA_DOMAIN y OKTA_CLIENT_ID estén establecidas en su archivo de variables de entorno. Por ejemplo:
export OKTA_DOMAIN=https://guidewire-hub.okta.com/oauth2/<SERVER_ID>
export OKTA_CLIENT_ID=<CLIENT_ID>

Cuándo usar estos comandos:

  • En entornos sin integración de navegadores. Si su entorno no abre automáticamente los navegadores, el comando de inicio de sesión muestra la URL de autenticación que puede copiar y abrir manualmente en el explorador.
  • Cuando solucione problemas de autenticación. Utilice el comando de cierre de sesión para borrar los tokens; luego, use el comando de inicio de sesión para volver a autenticarse.
  • Al cambiar entre cuentas. Utilice el comando de cierre de sesión; luego, el comando de inicio de sesión para autenticarse con una cuenta diferente.

Contact us​

For help with installation or setup, the following Slack resources are available:

  • For questions and information about the Developer Assistant MCP functionality, you can visit the Developer Assistant MCP user group: #developer-assistant-mcp-users
  • For urgent issues or bugs, you can tag the interrupt group: @jutro-developer-assistant-interrupt