arkerah
Tus coincidencias laborales corporativas clasificadas en cinco países europeos, leídas desde tu asistente de IA.
Servidor MCP alojado
npx add-mcp 'https://app.arkerah.com/api/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
Conecta tu asistente de IA a arkerah
El servidor MCP de arkerah permite que un asistente de IA que hable el Protocolo de Contexto de Modelos, como Claude, trabaje con tu propia cuenta de arkerah. Puede leer tus empleos clasificados, un empleo completo, por qué algunos empleos no se te muestran y qué sabe arkerah sobre ti. Puede sugerir tres cambios, y nada cambia hasta que lo confirmes en arkerah.
¿Qué es el servidor MCP de arkerah?
Es una dirección, https://app.arkerah.com/api/mcp, que habla el Protocolo de Contexto de Modelos sobre HTTP Transmisible. Un cliente que pueda iniciar sesión con OAuth o enviar un token portador puede conectarse a él: claude.ai, Claude Desktop y Claude Code son aquellos para los que fue creado.
Cada herramienta llama a la misma función que llama la aplicación de arkerah. Tu asistente ve la lista que te muestra el mapa, clasificada de la misma manera y con tus propios filtros aplicados, y nada sobre nadie más.
El servidor no guarda nada entre dos llamadas, y solo lee un token portador. Una cookie de navegador que se le envíe se ignora, por lo que una página web no puede aprovechar tu sesión iniciada para acceder a él. Lo que tu asistente lee sale de arkerah y va al proveedor de ese asistente, bajo sus propios términos.
¿Qué puede leer tu asistente?
Cinco herramientas leen, y ninguna de ellas cambia nada.
| Herramienta | Qué recibe | Qué devuelve |
|---|---|---|
search_jobs | Opcionalmente un lugar (una ciudad, una provincia o un código de país como NL) y un límite, hasta 50 | Tus empleos clasificados: título, empresa, lugar, clasificación, fecha de publicación y el enlace de LinkedIn |
job_details | El id search_jobs devuelto | Un empleo completo: el texto del anuncio, sus requisitos, los idiomas que pide, salario si se indica, nivel y enlace |
why_not | Una pregunta sencilla, como empleos de ventas en Ámsterdam | Empleos que no se te muestran, y cuál de tus propios filtros se interpone en cada uno |
what_you_know_about_me | Nada | Cada dato vigente que arkerah tiene sobre ti, por tema, y si lo declaraste, se leyó de un documento o se infirió |
count_jobs | Un nivel (país, región o ciudad), opcionalmente dentro de un lugar | Cuántos de tus empleos hay por lugar: los números en el mapa |
Mirar no marca un empleo como visto, no reconstruye cómo se te empareja y no llama a ningún modelo de lenguaje. Lo único que una llamada escribe sobre ti es cuándo se usó el token por última vez y cuántas llamadas ha hecho en esta hora.
¿Qué puede sugerir, y cómo lo confirmas?
hide_company: dejar de mostrar empleos en la empresa de un empleo que nombre.show_company_again: mostrar una empresa que ocultaste.correct_fact: corregir algo que arkerah tiene sobre ti, o añadir algo nuevo.
Ninguna de ellas cambia nada por sí sola. Cada una pone una tarjeta en tu chat de soporte de arkerah que comienza con Tu asistente de IA pidió esto y nombra exactamente qué cambiaría. Abre el chat de soporte, el icono de búsqueda en la esquina superior derecha, y pulsa Guardar en un dato o Sí, hazlo en una acción. No hacerlo lo rechaza. Una tarjeta solo puede responderse una vez.
¿Por qué no confiar en el aviso de aprobación del propio asistente? Porque puede configurarse para permitir siempre, muestra los argumentos del modelo en lugar del cambio en palabras, y es el asistente pidiendo llamar a arkerah, no arkerah preguntándote sobre tu propio registro. El aviso aún ayuda como primer filtro. Simplemente no es tu sí.
correct_fact hace una llamada al modelo para leer lo que se le dio, la misma llamada que hace el chat de soporte, y comparte el límite del chat de 60 por hora, por lo que un asistente no puede gastar más de lo que tú podrías escribir.
¿Qué nunca puede hacer?
- Eliminar tu cuenta, cambiar tu contraseña o tu correo electrónico, o generar un CV. No hay herramienta para ninguna de ellas, y una llamada con uno de esos nombres se rechaza.
- Solicitar un empleo. arkerah nunca solicita por ti.
- Leer la cuenta de nadie más. Cada token pertenece a una cuenta, y cada herramienta se ejecuta como esa cuenta.
- Cambiar nada a través de una herramienta de lectura.
- Hacer más de 300 llamadas por hora en un token o una aplicación conectada. Más allá de eso se le dice que intente de nuevo más tarde, con un tiempo de espera.
¿Cómo conectas Claude en claude.ai o Claude Desktop?
- Abre Configuración, luego Conectores, luego Añadir conector personalizado.
- Pega la dirección
https://app.arkerah.com/api/mcp. Deja el ID de cliente y el secreto de cliente vacíos. - Claude encuentra el inicio de sesión de arkerah por sí mismo y abre la pantalla de consentimiento de arkerah. Si has cerrado sesión, inicia sesión con tu correo electrónico o con Google primero, y vuelves a la misma pantalla.
- Lee lo que la pantalla dice que la aplicación puede hacer, luego pulsa Permitir, o No, gracias.
Eso es todo. La aplicación ahora aparece en arkerah bajo Configuración, Conecta un asistente de IA, Aplicaciones conectadas, donde puedes desconectarla en cualquier momento.
¿Cómo conectas Claude Code u otro cliente local?
Crea un token personal en arkerah: abre Configuración, luego Conecta un asistente de IA, dale un nombre al token y pulsa Crear un token. Se muestra una sola vez, así que cópialo entonces. Configuración imprime el comando exacto con tu token dentro. Para Claude Code es:
claude mcp add --transport http arkerah https://app.arkerah.com/api/mcp \
--header "Authorization: Bearer ark_pat_YOUR_TOKEN"
Cualquier otro cliente que pueda establecer una cabecera funciona de la misma manera: envía el token como Authorization: Bearer. En un archivo .mcp.json se ve así:
{
"mcpServers": {
"arkerah": {
"type": "http",
"url": "https://app.arkerah.com/api/mcp",
"headers": { "Authorization": "Bearer ark_pat_YOUR_TOKEN" }
}
}
}
Claude Code puede iniciar sesión con OAuth en su lugar: ejecuta el mismo comando sin la cabecera, luego escribe /mcp para iniciar sesión. Puedes tener hasta cinco tokens personales a la vez.
¿Cómo funcionan OAuth y el consentimiento?
arkerah es su propio servidor de inicio de sesión, siguiendo la especificación de autorización de MCP. Cuando un cliente llama sin un token válido, arkerah responde 401 y señala un documento que dice dónde iniciar sesión. El cliente se registra, luego te envía a la pantalla de consentimiento de arkerah con un desafío PKCE de un solo uso, por lo que un código que reciba es inútil para cualquier otra persona.
La pantalla de consentimiento muestra el nombre de la aplicación, tu cuenta, a dónde va la respuesta y qué permite cada permiso. Permitir envía a la aplicación un código que funciona una vez y dura cinco minutos. La aplicación lo intercambia por un token de acceso que dura una hora y un token de actualización que dura 30 días.
| Permiso | Qué dice la pantalla de consentimiento |
|---|---|
| leer | Lee tus empleos clasificados, un empleo completo, por qué los empleos no se te muestran y qué sabe arkerah sobre ti. |
| proponer | Sugiere un cambio, como ocultar una empresa o corregir algo sobre ti. Nada cambia hasta que lo confirmes en el chat de soporte de arkerah. |
Los tokens se almacenan solo como un hash de un solo sentido. Un token de actualización funciona una vez, y si alguna vez se presenta dos veces, arkerah termina toda la conexión, porque significa que dos partes lo tienen. Cada token funciona solo en la dirección MCP propia de arkerah. Una aplicación que pida solo leer no recibe las tres herramientas de sugerencia.
| Comparado | OAuth, un conector personalizado | Un token personal |
|---|---|---|
| Hecho para | claude.ai y Claude Desktop | Claude Code, o cualquier cliente que pueda enviar una cabecera |
| Cómo lo obtienes | Inicia sesión y pulsa Permitir | Configuración, Crear un token, mostrado una vez |
| Cuánto dura | Una hora, renovado por un token de actualización de 30 días mientras esté en uso | Hasta que lo revoques |
| Qué puede hacer | Leer y proponer, o solo leer si la aplicación lo pide | Leer y proponer |
| Límite | 300 llamadas por hora por aplicación conectada | 300 llamadas por hora por token, cinco tokens como máximo |
| Cómo terminarlo | Desconectar | Revocar |
¿Cómo desconectas un asistente?
En arkerah, abre Configuración, luego Conecta un asistente de IA. Cada aplicación que conectaste con OAuth se lista bajo Aplicaciones conectadas, con el día en que se conectó, cuándo se usó por última vez y si puede sugerir cambios. Desconectar termina cada token que esa aplicación tenga, en su próxima llamada.
Cada token personal se lista con su nombre, sus últimos cuatro caracteres y cuándo se usó por última vez. Revocar lo termina, y la siguiente llamada con él se rechaza.
Eliminar tu cuenta elimina cada token y cada conexión con ella. Tu exportación lista las aplicaciones y tokens que tenías, nunca los tokens mismos.
¿Qué no hace todavía?
search_jobsdevuelve hasta 50 empleos a la vez, sin paginación. Limita por lugar para ver más.- Una aplicación no puede revocar su propio token a través de la API. Lo desconectas en Configuración.
- Una tarjeta en el chat de soporte dice Tu asistente de IA pidió esto, no qué asistente.
Preguntas
¿Qué asistentes pueden conectarse?
Cualquier cliente MCP que hable HTTP Transmisible y pueda iniciar sesión con OAuth o enviar un token portador. claude.ai, Claude Desktop y Claude Code son los clientes para los que fue creado.
¿Mi asistente ve los datos de otras personas?
No. Cada token pertenece a una cuenta, y cada herramienta se ejecuta como esa cuenta.
¿Puede mi asistente cambiar mi perfil sin preguntarme?
No. Una sugerencia es una tarjeta en tu chat de soporte, y solo tu Guardar o Sí, hazlo hace el cambio.
¿Conectar un asistente cuesta algo?
No. arkerah es gratuito mientras esté en acceso temprano, y eso incluye conectar un asistente.
¿Un asistente que lee mis empleos los marca como vistos?
No. Las herramientas de lectura no cambian nada en tu lista, incluido lo que cuenta como nuevo.
¿Qué pasa con una conexión si elimino mi cuenta?
Se va con la cuenta, de inmediato, junto con cada token personal.