iWind AIFin Connector

English | 中文

Wind 금융 데이터 MCP 서비스와 ChatGPT Work, Grok Web, Codex 등 MCP 지원 클라인트와 같은 AI 에이전트 사의의 자체 호스팅, 읽기 전용 브리지입니다.

이 저장소는 호스팅 데이터 서비스가 아니며 Wind 접근 권한을 포함하지 않습니다. 사용자는 자신의 Wind 이용 권한과 API 키를 준비하고, 게이트웨이를 자신의 Cloudflare 계정에 배포한 다음, 에이전트를 결과로 생성된 OAuth MCP 엔드포인트에 연결합니다.

이 프로젝트가 존재하는 이유

Wind는 여러 MCP 서비스를 통해 유용한 금융 데이터를 제고합니다. 모은 에이전트에서 각 서비스와 각 API 키를 별도로 구서하는 것은 유지 관리가 어렵습니다. 특히 키가 할당량에 도달한 경우에는 더욱 그렇습니다.

iWind AIFin Connector는 하니의 안정적인 OAuth 보호 MCP 엔드포인트와 하니의 량타임 중립적 Skill을 제고합니다:

ChatGPT Work / Grok Web / local agent
              │
              ├── Skill: intent routing, data-quality checks, fail-closed rules
              │
              └── OAuth MCP connection
                         │
                         ▼
               Cloudflare Worker gateway
               ├── OAuth and access control
               ├── 31-tool read-only manifest
               ├── serial ordered key pool (two slots by default)
               └── sanitized operations notices
                         │
                         ▼
                  Six Wind MCP services

아래에 설명된 Cloudflare Plugin은 설정 및 유지 관리 도우미입니다. 에이전트가 Cloudflare 리소스를 생서하거나 검사하는 데 도움을 줄 수 있지만, 프로덕션 Wind 리 데이터 경로의 일부는 아닙니다.

Related MCP server: Wind MCP

제고 기능

통합 Wind 도메인

게이트웨이는 거래나 쓰기 작업을 노출하지 않습니다.

키 순환 작동 방식

현재 릴리즈에는 정확히 두 개의 순서가 있는 슬롯(key-01 및 key-02)이 포함됩니다.

1. 요청은 key-01을 사용할 수 있는 동안 사용합니다.

2. 게이트웨이는 명시적으로 분류된 할당량, 잔액, 인증 또는 운영자 상태가 허용하는 경우에만 슬롯을 변경합니다.

3. 일일 할당량이 소진되면 후속 작업을 key-02로 이동할 수 있습니다.

4. 속도 제한, 동시성 오류, 시간 초과, 네트워크 오류, 업스트림 5xx 응답, 알 수 없는 오류는 풀을 소진시키지 않습니다.

5. 에이전트는 순환이 발생했거나 실패했거나 풀을 사용할 수 없을 때 정제된 알림을 받습니다. 키 값과 원시 인프라 세부 정보는 절대 포함되지 않습니다.

이것은 순서가 지정된 할당량 장애 조치이며, 라운드로빈 로드 밸런싱도 아니고 Wind 계정 또는 계약 한도를 우회하는 방법도 아닙니다. Wind 계약에 따라 법적으로 풀링할 수 있는 키만 사용하세요.

KeyPool 코어는 명시적 우선순위가 있는 슬롯을 저장하고 우선순위가 가장 높은 적격 슬롯을 선택하므로, 동일한 직렬 정책이 향후 key-03, key-04 및 추가 슬롯을 지원할 수 있습니다. 현재 릴리즈는 추가 Secrets를 자동으로 발견하지 않습니다. 세 번 키를 추가하려면 슬롯 계약, Secret 바인딩 맵, 배포 구서, 관린 라우트, 테스트, 문서를 업데이트한 다음 게이트웨이를 재배포해야 합니다. MCP 엔드포인트, 31개 도구 매니페스트, OAuth 흐름, Skill 패키지는 풀이 커진다는 이우만으로 변경할 필요가 없습니다.

전제 조건

다음이 필요합니다:

• 통합 MCP 서비스를 사용할 수 있는 Wind AIFin 계정 또는 이용 권한.

• 이 저장소의 현재 2-슬롯 풀용 Wind API 키 2개. 키는 절대 이 저장소에 커밋하면 안 됩니다.

• Workers, KV, Durable Objects, Cron Triggers, 승인된 Access/OIDC 애플리케이션을 갖춘 Cloudflare 계정.

• Git, npm, Node.js >=24.13.1.

• 배포된 서비스를 사용하기 위한 MCP 지원 에이전트 또는 클라이언트.

Cloudflare, Wind, ID 공급자, AI 플랫폼 요금 또는 한도는 해당 서비스에 의해 관리되며 이 저장소에 포함되지 않습니다.

권장: Cloudflare Plugin을 먼저 설치하세요

ChatGPT 또는 Codex가 Cloudflare 리소스를 프로비저닝하고 유지 관리하도록 하려면 배포를 시작하기 전에 공식 Cloudflare Plugin을 설치하세요:

1. OpenAI Plugin 디렉터리를 열고 Cloudflare를 검색하여 설지한 다음 Cloudflare OAuth를 완료하세요.

2. 승인하기 전에 요청된 Cloudflare 권한을 검토하세요.

3. 에이전트가 어떤 리소스도 변경하기 전에 이 저장소의 설치 런북과 보안 경계를 읽도록 요청하세요.

재사용 가능한 Cloudflare Skills는 Apache-2.0 라이선스의 cloudflare/skills 저장소에도 게시되어 있습니다:

npx skills add https://github.com/cloudflare/skills

OpenAI 배포 패키지 구조는 openai/plugins › cloudflare에서 확인할 수 있습니다. 이 공개 저장소들은 Plugin/Skill 지침과 연결 패키징을 포함합니다. 그들이 연결하는 호스팅 Cloudflare API MCP 서비스는 별도의 원격 서비스입니다. 그 서버 구현이 두 저장소 중 하나에 포함되어 있다고 가정하지 마세요.

이 Plugin 설치는 에이전트 안내 설정에 권장되지만, 배포된 iWind 게이트웨이는 량타임에 Plugin에 의존하지 않습니다. 자격을 갖춘 운영자는 Wrangler 량북을 직접 따를 수 있습니다.

빠른 시작

1. 저장소 클론

git clone https://github.com/Rainnystone/iwind-connector.git
cd iwind-connector
npm ci

2. 프라이빗 Wind 키 준비

저장소 외부에 프라이빗 env 파일을 만드세요. 이 프로젝트의 로컬 규칙은 ../.secets/iwind.keys.env입니다:

WIND_API_KEY_01=replace-with-your-first-key
WIND_API_KEY_02=replace-with-your-second-key

파일을 소유자만 접근할 수 있도록 제한하세요. 실제 값을 소스 파일, Markdown, 채팅 메시지, 스크린샷, 명령 인자 또는 배포 JSON에 붙여넣지 마세요.

Cloudflare 배포에는 gateway/wrangler.jsonc의 secrets.required 아래에 나열된 Secret 바인딩 이름도 필요합니다. 승인된 보호 입력을 통해 값을 제고하세요. 체크인된 안전한 센틴널을 프로덕션 값으로 절대 교체하지 마세요.

3. 체크아웃 검증

저장소 트에서 실헹하세요:

npm test
npm run typecheck
npm run lint
npm run contract:verify
npm run build

npm run build는 Wrangler 드라이 량이며 배포하지 않습니다. 공유 dist/ 디렉터리를 지울 수 있으므로 빌드 후 항상 Skill을 패키징하세요:

npm run skill:package
npm run secret:scan -- --secrets-file '../.secrets/iwind.keys.env'

생성된 아카이브는 다은과 같습니다:

dist/iwind-aifin-connector-skill.zip

4. Cloudflare 계정에 게이트웨이 배포

docs/installation.md를 정확히 따르세요. 다은 방법을 설명합니다:

• OAuth KV 네임스페이스를 생서하거나 선택하는 방법;

• 소스 센틴널을 변경하지 않고 배포 전용 Wrangler 구성을 생서하는 방법;

• 보호된 입력을 통해 필요한 모은 Secrets를 제고하는 방법;

• Worker, Durable Object, KV, cron, origin, OAuth 구성을 검토하는 방법;

• 별도 승인된 배포 전에 드라이 량을 수행하는 방법;

• OAuth, 31개 읽기 전용 도구, 대표 쿼리 하나, 키 풀 상태를 검증하는 방법.

에이전트가 도움을 주는 경우 안전한 시작 요청은 다은과 같습니다:

README.md, docs/installation.md, docs/security.md를 읽으세요. 필요한 Cloudflare 리소스와 Secret 바인딩을 설명하세요. 정확한 계획을 보여주고 내가 승인할 때까지 아무것도 생서, 수정, 배포하지 마세요.

배포는 외부 인프라를 변경합니다. 승인하기 전에 대상 Cloudflare 계정, 리소스 이름, OAuth 정책, 공개 origin, 예상 서비스 비용을 검토하세요.

5. 에이전트 연결

모든 곳에서 동일한 Skill 아카이브와 동일한 배포 OAuth MCP 엔드포인트를 사용하세요:

• ChatGPT Work: 배포된 /mcp URL을 OAuth 사용자 지정 Plugin으로 등록한 다음 Skill zip을 별도 항목으로 업로드하세요.

• Grok Web: OAuth MCP 커넥터를 등록하고 현재 제품 UI에 따라 동일한 Skill 아카이브를 설지하세요.

• 로컬 클라이언트: Skill 아키브를 설지하고 제고된 MCP 구서 예제를 조정하세요.

Skill은 MCP 연결을 설지하거나 인증하지 않으며, MCP 연결도 Skill을 자동으로 설치하지 않습니다. 클라우드 런타임에서는 두 단계가 모두 필요합니다.

6. 읽기 전용 스모크 테스트 실행

알려진 표준 Wind 코드와 간단한 스냅샷 요청으로 시작하세요. 다음을 확인하세요:

• 클라이언트가 Web Search 대신 iWind MCP를 사용하는지;

• 선택한 도구가 요청된 데이터 유형과 일치하는지;

• 호출이 직렬인지;

• 응답이 날짜, 단위, null, 커버리지를 보존하는지;

• 일반적인 성공에 운영 경고가 없는지;

• 답변에 자격 증명이나 원시 진단 정보가 나타나지 않는지.

회사 이름이나 불확실한 코드의 경우, Skill은 먼저 종목 식별을 검색하고 회사, 표준 Wind 코드, 시장을 검증한 다음에만 속성 또는 가격 도구를 호출해야 합니다.

운영 및 유지 관리

• 운영: 풀 검사, 키 교체/추가/비활성화/복원, Wind 스키마 스냅샷 새로 고침.

• 문제 해결: 안정적인 OAuth, 게이트웨이, 키 풀, Wind 오류 코드를 해석.

• 보안: Secret 처리, 로깅 허용 목록, 패키지 스, 릴리즈 게이트.

• 수용 체크리스트: 전제 검증된 릴리스 경계와 남은 플랫폼별 검사.

운영 편법으로 키 풀 크기, 순환 의미, OAuth 정책, 공개 엔드포인트, 도구 스키마 또는 읽기 전용 범위를 변경하지 마세요. 이러한 변경은 아키텍처 변경이며 구현과 검토가 필요합니다.

저장소 구조

skill/                 Runtime-neutral Agent Skill, references, and evals
gateway/               Cloudflare Worker OAuth MCP gateway
adapters/              ChatGPT Work, Grok Web, and local installation notes
scripts/               Packaging, verification, Secret scanning, and deploy rendering
docs/                  Installation, operations, security, troubleshooting, and acceptance
dist/                  Generated and ignored release artifacts

Skill 패키지에는 고정된 iwind-aifin-connector/ 루트 아래 SKILL.md, references/*.md, evals/*.json만 포함됩니다. 엔드포인트, Wind 키, OAuth 자격 증명, 게이트웨이 코드, 플랫폼 메타데이타 또는 복사된 도구 스키마는 포함되지 않습니다.

검증 상태

저장소는 자동화된 단위, 통합, MCP/OAuth, 키 순환, 직렬화, 패키징, Secret 스캔, 드라이 런 빌드 테스트 범위를 갖추고 있습니다. 프로덕션 MCP 경로는 31개의 고유한 읽기 전용 도구와 대표적인 직렬 쿼리로 검증되었습니다.

ChatGPT Work custom-Plugin 등록, OAuth, 도구 검색, 그리고 대표 쿼리가 검증되었습니다. 최종 Skill 업로드, 자동 Skill 호출, 그리고 예약 작업 동작은 계정 수준 승인 단계로 남아 있습니다. Grok Web 어댑터는 제공되지만 실제 Grok 계정에서 아직 검증되지 않았습니다. 현재 경계는 승인 체크리스트를 참조하십시오.

공개 저장소, 라이선스, 데이터 액세스

이 소스 저장소는 구현과 운영 모델을 검사할 수 있도록 공개되어 있습니다. 그렇다고 해서 배포된 게이트웨이가 공개 데이터 서비스가 되는 것은 아니며, 이 저장소는 Wind 데이터 액세스를 포함하거나 부여하지 않습니다. 모든 운영자는 자신의 Cloudflare 계정, ID 구성, Wind 자격, 그리고 개인 API 키를 사용해야 합니다.

이 저장소에는 현재 LICENSE 파일이 없습니다. 공개적으로 보인다고 해서 일반적인 오픈소스 재사용 라이선스가 부여되는 것은 아니므로, 라이선스가 추가되기 전까지는 이 프로젝트를 라이선스가 부여된 오픈소스로 설명해서는 안 됩니다. 재배포나 제3자 기여를 장려하기 전에 적절한 라이선스를 선택하여 추가하십시오.

이 프로젝트를 포크, 배포, 또는 재배포하는 경우:

• 자격 증명, OAuth 산출물, 계정 식별자, 비공개 배포 기록, 임시 콜백 URL, 또는 비즈니스 응답을 절대 커밋하지 마십시오.

• 전체 검증, 결정적 패키징, 그리고 정확 값 Secret 스을 자신의 개인 키 파일에 대해 실행하십시오.

• 생성된 계약 정보를 재배포하거나 다른 사람에게 서비스를 제공하기 전에 Wind 계약을 검토하십시오.

• 다른 보안 경계가 의도적으로 설계, 승인, 구현, 그리고 검토되지 않는 한 게이트웨이를 읽기 전용으로 유지하십시오.

Wind 및 iWind 제품 이름은 각각의 소유자에게 귀속됩니다. 이 프로젝트는 독립적인 통합 프로젝트이며, Wind와 제휴하지 않으며 Wind의 보증을 받지 않습니다. 이 프로젝트는 Wind 데이터를 제공하거나 재판매하지 않으며, Wind 데이터 액세스 권한을 부여하지도 않습니다.