Wordware MCP 서버

Claude 대화에서 직접 사용할 수 있는 도구로 Wordware 배포 흐름을 통합할 수 있는 MCP(Model Context Protocol) 서버 구현입니다.

특징

• MCP를 통한 Claude와의 통합
• 다음을 포함한 기본 Wordware 도구 지원:
  • Research Founder: 포괄적인 창업자 분석 및 회의 준비
  • 리드 강화: 영업 잠재 고객 조사 및 정보
  • Notion에 저장: Notion에 직접 페이지 저장
  • React Agent: Google 검색 및 API 기능을 활용한 작업 해결

설정

1. 루트 디렉토리에 있는 env.example.ts 파일을 수정하여 env.ts 로 설정하고 내부 변수를 설정합니다.

일반 .env 파일을 사용하는 것은 서버 환경(Claude Desktop 설정 내부)에서도 해당 변수에 접근할 수 있도록 해야 한다는 점을 고려하면 복잡해 보였습니다. 더 나은 해결책을 찾으면 다시 확인해 보세요.

• OPENAI_API_KEY : OpenAI API 키( add-tool.ts 에서 Wordware 흐름에 대한 제공된 정보에서 zod 스키마를 생성하는 데 사용됨)
• NOTION_SECRET : Notion 비밀번호
• NOTION_PARENT_PAGE_ID : 저장할 Notion 페이지의 ID
• SAVE_TO_NOTION_APP_ID : 배포된 Save to Notion 앱의 ID
• RESEARCH_FOUNDER_APP_ID : 배포된 Research Founder 앱의 ID
• LEAD_ENRICHMENT_APP_ID : 배포된 Lead Enrichment 앱의 ID
• REACT_AGENT_APP_ID : 배포된 React Agent 앱의 ID

saveToNotion 도구에 대한 Notion을 설정하려면 여기의 지침을 따르세요.

4가지 도구 중 하나를 사용하지 않으려면 해당 env 변수를 비워두면 도구가 등록되지 않습니다.

2. 종속성을 설치하고 서버를 빌드합니다.

지엑스피1

3. Claude를 사용하여 데스크톱 서버 테스트

서버를 테스트하려면 Claude for Desktop이 설치되어 있어야 합니다. 설치된 경우 MCP 서버를 사용하도록 구성 파일을 수정해야 합니다. 다음 명령을 실행하여 구성 파일을 엽니다(VSCode를 사용하는 경우).

그런 다음, 다음을 파일에 추가합니다(이 저장소의 build 폴더에 있는 index.js 파일의 절대 경로로 /ABSOLUTE/PATH/TO/PARENT/FOLDER/wordware/build/index.js 를 바꿔야 합니다).

4. add-tool 명령 사용(선택 사항이지만 권장됨)

참고: add-tool 명령은 몇 가지 간단한 Wordware 플로우에서만 테스트되었습니다. 스키마 생성을 위해 OpenAI를 사용하므로, 사용하기 전에 도구의 출력을 반드시 확인하세요.

도구를 실행하려면:

향후 개선 사항

동적 도구 구성

현재 해당 도구는 서버 구현에 하드코딩되어 있습니다. 향후 개선 사항은 다음 사항에 중점을 둘 예정입니다.

• Wordware API를 사용하여 인증 구현
• 사용자의 배포를 자동으로 가져오는 기능 추가
• 어떤 배포를 자동으로 MCP 도구로 추가할 수 있는지 알아보세요.
• 복잡한 블록에 대한 더 나은 지원(예: "사람에게 질문하기" 블록)
• 도구 호출에 대한 더 나은 오류 처리