Integración de Zerodha MCP

Este proyecto integra la plataforma comercial de Zerodha con Claude AI utilizando el marco Multi-Cloud Plugin (MCP), lo que le permite interactuar con su cuenta comercial de Zerodha directamente a través de Claude.

Instrucciones de configuración

1. Crea una cuenta de desarrollador de Zerodha

1. Vaya a Kite Connect y regístrese para obtener una cuenta de desarrollador
2. Inicie sesión en su cuenta en developer.kite.trade

2. Crear una nueva aplicación

1. Vaya a la sección "Aplicaciones" en su panel de Kite Developer
2. Haga clic en "Crear una nueva aplicación"
3. Complete los datos requeridos:
   • Nombre de la aplicación: Elija un nombre descriptivo (por ejemplo, "Integración de Claude Zerodha")
   • Categoría de la aplicación: seleccione "Personal" o la categoría adecuada
   • URL de redireccionamiento: Establezca en http://127.0.0.1:5000/zerodha/auth/redirect
   • Descripción: Describa brevemente el propósito de su aplicación.
4. Envíe el formulario para crear su aplicación

3. Obtener credenciales de API

Después de crear tu aplicación, recibirás:

• Clave API (también llamada clave de consumidor)
• Secreto de API (también llamado secreto del consumidor)

Estas credenciales se mostrarán en la página de detalles de su aplicación.

4. Configurar variables de entorno

1. Cree un archivo .env en el directorio raíz de este proyecto
2. Agregue sus credenciales de API al archivo:

Reemplace your_api_key_here y your_api_secret_here con las credenciales reales del paso 3.

5. Instalar dependencias

Asegúrese de tener instaladas todas las dependencias necesarias:

6. Instale la configuración de MCP en su aplicación de escritorio Claude

Instale la configuración de MCP en su aplicación de escritorio Claude:

Este comando registra el complemento Zerodha con Claude, lo que hace que toda la funcionalidad comercial esté disponible para la IA.

Uso

Después de la configuración, puede interactuar con su cuenta Zerodha a través de Claude utilizando las siguientes funciones:

Autenticación

Acciones y comercio en general

• Consultar márgenes de cuenta: What are my current margins on Zerodha?
• Ver las tenencias de la cartera: Show me my current holdings on Zerodha
• Consultar puestos actuales: What positions do I currently have open on Zerodha?
• Obtener cotizaciones para los símbolos: What's the current price of RELIANCE and INFY on NSE?
• Realizar una orden: Place a buy order for 10 shares of INFY at market price on NSE
• Obtener datos históricos: Can you show me the historical price data for SBIN for the last 30 days?

Fondos mutuos

• Ver tenencias de fondos mutuos: Show me my mutual fund holdings on Zerodha
• Obtener órdenes de fondos mutuos: List all my mutual fund orders on Zerodha
• Realizar una orden de compra de fondos mutuos: Place a buy order for ₹5000 in the mutual fund with symbol INF090I01239
• Cancelar una orden de fondos mutuos: Cancel my mutual fund order with order ID 123456789
• Ver detalles de SIP: Show all my active SIPs on Zerodha
• Crear un nuevo SIP: Set up a monthly SIP of ₹2000 for the fund with symbol INF090I01239 for 12 installments
• Modificar un SIP existente: Change my SIP with ID 987654321 to ₹3000 per month
• Cancelar un SIP: Cancel my SIP with ID 987654321
• Explorar los fondos mutuos disponibles: Show me a list of available mutual funds on Zerodha

Flujo de autenticación

La primera vez que utilice cualquier funcionalidad de Zerodha, Claude hará lo siguiente:

1. Iniciar un servidor local en el puerto 5000
2. Abra una ventana del navegador para iniciar sesión en Zerodha
3. Después de iniciar sesión correctamente, guarde el token de acceso para futuras sesiones

Su sesión permanecerá activa hasta que caduque el token (normalmente 24 horas). Cuando caduque, Claude reiniciará automáticamente el proceso de inicio de sesión.

Herramientas MCP disponibles

Este complemento ofrece las siguientes herramientas MCP que Claude puede usar:

Autenticación

• check_and_authenticate : verifica el estado de autenticación e inicia el inicio de sesión si es necesario
• initiate_login - Inicia el flujo de inicio de sesión de Zerodha
• get_request_token : recupera el token de solicitud después de iniciar sesión

Comercio de acciones/en general

• get_holdings - Recupera las tenencias de la cartera
• get_positions - Obtiene las posiciones actuales
• get_margins - Recupera los márgenes de la cuenta
• place_order - Coloca una orden comercial
• get_quote - Obtiene comillas para los símbolos especificados
• get_historical_data - Recupera datos históricos de precios

Fondos mutuos

• get_mf_orders - Recupera órdenes de fondos mutuos
• place_mf_order - Realiza una orden de fondos mutuos
• cancel_mf_order - Cancela una orden de fondos mutuos
• get_mf_instruments : obtiene los instrumentos de fondos mutuos disponibles
• get_mf_holdings - Recupera las tenencias de fondos mutuos
• get_mf_sips - Obtiene los SIP activos
• place_mf_sip - Crea un nuevo SIP
• modify_mf_sip - Modifica un SIP existente
• cancel_mf_sip - Cancela un SIP

Solución de problemas

• Si encuentra problemas de autenticación, intente eliminar el archivo .tokens y reinicie el proceso de autenticación.
• Asegúrese de que sus credenciales de Zerodha en el archivo .env sean correctas
• Asegúrese de que el puerto 5000 no esté siendo utilizado por otra aplicación
• Para problemas persistentes, verifique el estado de la API de Zerodha en status.zerodha.com

Notas de seguridad

• Sus credenciales de API de Zerodha se almacenan únicamente en su archivo .env local
• Los tokens de acceso se almacenan en el archivo .tokens en el directorio del proyecto
• No se transmiten credenciales a Claude ni a terceros.
• Toda la autenticación ocurre directamente entre usted y los servidores de Zerodha.