Conectar Gemini Enterprise a ActivityInfo

Idioma: Español

Este artículo se ha traducido del inglés mediante IA y puede contener errores. Sus comentarios nos ayudarán a mejorar.

Gemini Enterprise se conecta a ActivityInfo a través de una conexión personalizada al servidor MCP. A diferencia de los otros asistentes de este manual, Gemini Enterprise no se registra en ActivityInfo, por lo que debe registrarlo usted mismo una vez y pegar el ID de cliente resultante en sus ajustes.

Antes de empezar

El servidor MCP tiene que estar habilitado para cada base de datos con la que quiera trabajar. Consulte Permitir el servidor MCP para una base de datos.
Lea Uso de asistentes de IA con datos sensibles antes de conectar una base de datos que contenga datos personales.
Debe ser administrador de su equipo de Gemini Enterprise.
Necesita una forma de enviar una solicitud HTTP, como curl o Postman, para el paso de registro.

Estos son los valores que necesitará:

| Ajuste | Valor || --- | --- || URL del servidor MCP | https://www.activityinfo.org/mcp | | URL de autorización | https://www.activityinfo.org/oauth/authorize | | URL del token | https://www.activityinfo.org/oauth/token | | Ámbitos | activityinfo.read activityinfo.write | | PKCE | Obligatorio |

Paso 1: Encontrar la URL de rellamada

Gemini Enterprise devuelve a los usuarios a una URL de rellamada después de que inicien sesión en ActivityInfo. Tiene que registrar esa URL exacta en ActivityInfo, así que encuéntrela primero.

Inicie sesión en Gemini Enterprise – Business edition.
Haga clic en “Settings & help”.
Seleccione su equipo, luego vaya a “Manage team” > “Connected apps”.
Haga clic en “Add MCP Server” y busque la URL de rellamada, a veces llamada URI de redireccionamiento, en los ajustes de autenticación.

Si la URL de rellamada solo aparece después de guardar la conexión, rellene el resto del formulario con un ID de cliente provisional, guarde, copie la URL de rellamada y vuelva para corregir el ID de cliente al final del Paso 2.

Paso 2: Registrar Gemini Enterprise en ActivityInfo

Envíe una solicitud de registro a ActivityInfo, con la URL de rellamada del Paso 1 como URI de redireccionamiento. La solicitud no necesita autenticación.

curl -X POST https://www.activityinfo.org/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
        "client_name": "Gemini Enterprise",
        "redirect_uris": ["<URL DE RELLAMADA DEL PASO 1>"]
      }'

ActivityInfo responde con un client_id:

{
  "client_id": "sQ8vK2mR7pX4nB9dL6tY3wF1jH5gC0aZ",
  "client_name": "Gemini Enterprise",
  "token_endpoint_auth_method": "none"
}

Guarde el client_id. Realice el registro una vez para su organización, no una vez por usuario. Para más información sobre este paso, consulte Registrar una aplicación OAuth.

ActivityInfo no emite ningún secreto del cliente, por lo que token_endpoint_auth_method es none. En su lugar, cada inicio de sesión está protegido por PKCE, que activará en el siguiente paso.

Paso 3: Añadir la conexión al servidor MCP

En la página “Connected apps”, en el panel “Add MCP Server”:

Rellene la información del MCP:

| Campo | Valor || --- | --- || URL del servidor | https://www.activityinfo.org/mcp | | Nombre | ActivityInfo |

| Campo | Valor || --- | --- || URL de autorización | https://www.activityinfo.org/oauth/authorize | | URL del token | https://www.activityinfo.org/oauth/token | | ID de cliente | El client_id del Paso 2 | | Secreto del cliente | ActivityInfo no emite ninguna e ignora este campo. Cuando se requiera un valor, ingrese cualquier marcador de posición, como not-used |

Haga clic en “Add”.

Paso 4: Permitir la conexión

Una nueva conexión al servidor MCP está deshabilitada hasta que usted la permita. Permita la conexión para que sea visible para su equipo.

Confirmar la conexión

Cada miembro del equipo inicia sesión en ActivityInfo con su propia cuenta la primera vez que utiliza la conexión, y la aprueba en la pantalla “Autorizar aplicación”. Solo ven lo que les permite su propio rol en ActivityInfo.

Pregunte:

List my ActivityInfo databases.

Solución de problemas

| Lo que ve | Causa || --- | --- || PKCE with code_challenge_method=S256 is required | PKCE no está activado para la conexión. Actívelo | | redirect_uri does not match a registered URI | La URL de rellamada registrada en el Paso 2 difiere de la que utiliza Gemini Enterprise. ActivityInfo compara toda la URL de forma exacta, incluyendo el puerto de PC y la ruta. Vuelva a registrarse con el valor exacto | | invalid_client: unknown client_id | El ID de cliente está mal escrito, o el registro fue eliminado porque ningún usuario lo había aprobado. Vuelva a registrarse | | La conexión no es visible para el equipo | La conexión sigue deshabilitada. Consulte el Paso 4 | | “El servidor MCP no está habilitado para la base de datos...” | Nadie ha habilitado el ajuste para esa base de datos. Consulte Permitir el servidor MCP para una base de datos | | “Prohibido: esta herramienta modifica datos, pero la autorización es de solo lectura” | El usuario concedió solo acceso de lectura. Puede revocar la autorización y aprobarla de nuevo, permitiendo cambios |